Method: courses.topics.patch

Aktualizuje jedno lub więcej pól tematu.

Ta metoda zwraca następujące kody błędów:

  • PERMISSION_DENIED, jeśli projekt dewelopera, który wysłał żądanie, nie utworzył odpowiedniego tematu lub wystąpił w przypadku błędów dostępu.
  • INVALID_ARGUMENT, jeśli żądanie jest uszkodzone.
  • NOT_FOUND, jeśli żądany kurs lub temat nie istnieje

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
courseId

string

Identyfikator zajęć. Może to być identyfikator przypisany przez Classroom lub alias.
id

string

Identyfikator tematu.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Maska identyfikująca pola w temacie, które mają zostać zaktualizowane. To pole jest wymagane do przeprowadzenia aktualizacji. Aktualizacja nie powiedzie się, jeśli podasz nieprawidłowe pola. Jeśli pole obsługuje puste wartości, można je wyczyścić, określając je w masce aktualizacji, a nie w obiekcie Topic. Jeśli pole, które nie obsługuje pustych wartości, zostanie uwzględnione w masce aktualizacji i nie jest ustawione w obiekcie Topic, zostanie zwrócony błąd INVALID_ARGUMENT.

Możesz wypełnić te pola:

  • name

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 Topic.

Treść odpowiedzi

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w przewodniku po autoryzacji.