Method: courses.patch

Zaktualizuje co najmniej 1 pole w kursie.

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

  • PERMISSION_DENIED jeśli użytkownik nie ma uprawnień do modyfikowania żądanego kursu lub w przypadku błędów dostępu.
  • NOT_FOUND, jeśli nie ma kursu o podanym identyfikatorze.
  • INVALID_ARGUMENT jeśli w masie aktualizacji są określone 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 zajęć do zaktualizowania. Identyfikatorem może być identyfikator przypisany przez Classroom lub alias.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Maska, która określa, które pola kursu należy zaktualizować. 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 dotyczące ownerId są traktowane jako natychmiastowe, ale w praktyce przeniesienie własności wszystkich dotkniętych zasobów może potrwać.

Gdy to pole jest ustawione w parametrze zapytania, powinno być określone jako

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

Jest to lista pełnych nazw pól rozdzielona przecinkami. 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 dotyczącym autoryzacji.