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 w przypadku tych błędów żądań:
    • 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. Identyfikator może być przypisany przez Classroom lub być 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:

  • courseState
  • description
  • descriptionHeading
  • name
  • ownerId
  • room
  • section
  • subject
  • learningStandardSettings
  • levels

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ą, 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".
previewVersion

enum (PreviewVersion)

Opcjonalnie. Wersja przedpremierowa interfejsu API. Musisz to ustawić, aby uzyskać dostęp do nowych funkcji interfejsu API udostępnionych deweloperom w ramach Programu testowania aktualizacji.

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.