Method: courses.students.create

Dodaje użytkownika jako ucznia zajęć.

Administratorzy domen mogą bezpośrednio dodawać użytkowników z ich domeny jako uczniów do zajęć w ich domenie. Uczniowie mogą dodawać się do zajęć za pomocą kodu rejestracji.

Ta metoda zwraca te kody błędów:

  • PERMISSION_DENIED jeśli użytkownik nie ma uprawnień do tworzenia uczniów w tym kursie lub z powodu błędów dostępu.
  • NOT_FOUND, jeśli żądany identyfikator kursu nie istnieje.
  • FAILED_PRECONDITION jeśli konto użytkownika, którego dotyczy prośba, jest wyłączone, w przypadku tych błędów żądania:
    • CourseMemberLimitReached
    • CourseNotModifiable
    • UserGroupsMembershipLimitReached
    • InactiveCourseOwner
  • ALREADY_EXISTS jeśli użytkownik jest już uczniem lub nauczycielem na zajęciach.

Żądanie HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/students

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
courseId

string

Identyfikator zajęć, w których chcesz utworzyć ucznia. Identyfikatorem może być identyfikator przypisany przez Classroom lub alias.

Parametry zapytania

Parametry
enrollmentCode

string

Kod rejestracji na zajęcia, w których chcesz utworzyć konto ucznia. Ten kod jest wymagany, jeśli userId odpowiada użytkownikowi przesyłającemu prośbę. Możesz go pominąć, jeśli użytkownik przesyłający prośbę ma uprawnienia administracyjne do tworzenia uczniów dla dowolnego użytkownika.

Treść żądania

Treść żądania zawiera wystąpienie elementu Student.

Treść odpowiedzi

Jeśli operacja się powiedzie, treść odpowiedzi będzie zawierała nowo utworzoną instancję Student.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/classroom.rosters
  • https://www.googleapis.com/auth/classroom.profile.emails
  • https://www.googleapis.com/auth/classroom.profile.photos

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.