Method: courses.patch

Aktualizuje co najmniej jedno pole w kursie.

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

  • PERMISSION_DENIED, jeśli użytkownik wysyłający żądanie nie ma uprawnień do modyfikowania kursu lub w przypadku błędów dostępu.
  • NOT_FOUND jeśli nie ma kursu o podanym identyfikatorze.
  • INVALID_ARGUMENT, jeśli w masce aktualizacji podano nieprawidłowe pola lub jeśli nie podano maski aktualizacji.
  • FAILED_PRECONDITION z powodu tych błędów żądania:
    • CourseNotModifiable
    • InactiveCourseOwner
    • IneligibleOwner
    • CourseTitleCannotContainUrl

Żą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. Ten identyfikator może być identyfikatorem przypisanym przez Classroom lub alias.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Maska, która określa, które pola kursu 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: zmiany w polu ownerId są traktowane jako obowiązujące natychmiast, ale w praktyce przeniesienie własności wszystkich zasobów, których dotyczą zmiany, może zająć trochę czasu.

Jeśli to pole jest ustawione w parametrze zapytania, należy je określić jako

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

Jest to lista w pełni kwalifikowanych nazw pól rozdzielonych 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 po autoryzacji.