Method: courses.patch

Aktualizuje jedno lub więcej pól w kursie.

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 zmodyfikowania żądanego kursu lub występuje błędy dostępu.
  • NOT_FOUND, jeśli nie ma zajęć o podanym identyfikatorze.
  • INVALID_ARGUMENT, jeśli w masce aktualizacji określono nieprawidłowe pola lub jeśli nie podano maski aktualizacji.
  • FAILED_PRECONDITION w przypadku tych błędów żądania:
    • CourseNotModifiable
    • InactiveCourseOwner
    • IneligibleOwner

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
id

string

Identyfikator kursu do zaktualizowania. Może to być identyfikator przypisany przez Classroom lub alias.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Maska identyfikująca pola na kursie, które mają zostać zaktualizowane. To pole jest wymagane do przeprowadzenia aktualizacji. Jeśli podasz nieprawidłowe pola, aktualizacja się nie powiedzie. Te pola są prawidłowe:

  • name
  • section
  • descriptionHeading
  • description
  • room
  • courseState
  • ownerId

Uwaga: poprawki do identyfikatora właściciela są traktowane jako natychmiastowe, ale w praktyce może minąć trochę czasu, zanim przeniesienie własności wszystkich zasobów, których dotyczy problem, może zająć trochę czasu.

Po ustawieniu parametru zapytania to pole powinno być określone jako

updateMask=<field1>,<field2>,...

Jest to lista rozdzielonych przecinkami pełnych i jednoznacznych nazw pól. Przykład: "user.displayName,photo".

Treść żądania

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

Treść odpowiedzi

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w przewodniku po autoryzacji.