Method: courses.students.create

Dodaje użytkownika jako ucznia na zajęciach.

Administratorzy domen mogą bezpośrednio dodawać użytkowników z domeny jako uczniów do zajęć w tej domenie. Uczniowie mogą dołączać do zajęć za pomocą kodu rejestracyjnego.

Ta metoda zwraca następujące kody błędów:

  • PERMISSION_DENIED, jeśli użytkownik wysyłający prośbę nie ma uprawnień do tworzenia uczniów na tych zajęciach lub występuje błędy dostępu.
  • NOT_FOUND, jeśli żądany identyfikator zajęć nie istnieje.
  • FAILED_PRECONDITION, jeśli konto żądanego użytkownika jest wyłączone z powodu 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 zostanie utworzony uczeń. Może to być identyfikator przypisany przez Classroom lub alias.

Parametry zapytania

Parametry
enrollmentCode

string

Kod rejestracji na zajęcia, w którym należy utworzyć ucznia. Ten kod jest wymagany, jeśli atrybut userId odpowiada użytkownikowi wysyłającemu prośbę. Może zostać pominięty, jeśli użytkownik wysył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ę uda, 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 po autoryzacji.