Method: courses.studentGroups.create

Tworzy grupę uczniów na potrzeby kursu.

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

  • PERMISSION_DENIED jeśli użytkownik wysyłający żądanie nie ma uprawnień do utworzenia grupy uczniów lub wystąpią błędy dostępu.
  • NOT_FOUND jeśli kurs nie istnieje lub użytkownik wysyłający żądanie nie ma do niego dostępu.
  • FAILED_PRECONDITION jeśli utworzenie grupy uczniów spowoduje przekroczenie maksymalnej liczby grup uczniów na kurs.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
courseId

string

Wymagany. Identyfikator kursu.

Parametry zapytania

Parametry
previewVersion

enum (PreviewVersion)

Opcjonalnie. Wersja przedpremierowa interfejsu API. Musisz ustawić tę wartość, aby uzyskać dostęp do nowych funkcji interfejsu API udostępnionych deweloperom w ramach programu podglądu.

Treść żądania

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

Treść odpowiedzi

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/classroom.rosters

Więcej informacji znajdziesz w przewodniku po autoryzacji.