Method: courses.studentGroups.patch

Aktualizuje co najmniej 1 pole w grupie uczniów.

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

  • PERMISSION_DENIED, jeśli użytkownik wysyłający żądanie nie ma uprawnień do modyfikowania żądanej grupy uczniów lub w przypadku błędów dostępu.
  • NOT_FOUND – jeśli grupa uczniów nie istnieje lub użytkownik nie ma do niej dostępu.
  • INVALID_ARGUMENT, jeśli w masce aktualizacji podano nieprawidłowe pola lub jeśli nie podano maski aktualizacji.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
courseId

string

Wymagany. Identyfikator szkolenia.
id

string

Wymagany. Identyfikator grupy uczniów.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Wymagany. Maska, która określa, które pola w grupie uczniów mają zostać zaktualizowane. To pole jest wymagane do przeprowadzenia aktualizacji. Jeśli podasz nieprawidłowe pola, aktualizacja się nie powiedzie.

Nauczyciele mogą określić te pola:

  • title

Jest to lista w pełni kwalifikowanych nazw pól rozdzielonych przecinkami. Przykład: "user.displayName,photo".
previewVersion

enum (PreviewVersion)

Opcjonalnie. Wersja podglądu punktu końcowego. 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

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu StudentGroup.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w przewodniku po autoryzacji.