Method: courses.topics.patch

Zaktualizuje co najmniej jedno pole tematu.

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

  • PERMISSION_DENIED jeśli projekt dewelopera, który wysłał żądanie, nie utworzył odpowiedniego tematu lub z powodu błędów dostępu.
  • INVALID_ARGUMENT jeśli żądanie ma nieprawidłowy format.
  • 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 kursu. Identyfikatorem może być identyfikator przypisany przez Classroom lub alias.
id

string

Identyfikator tematu.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Maska, która określa, które pola tematu mają zostać zaktualizowane. To pole jest wymagane do przeprowadzenia aktualizacji. Jeśli podasz nieprawidłowe pola, aktualizacja się nie powiedzie. Jeśli pole obsługuje puste wartości, można je wyczyścić, podając je w masce aktualizacji, a nie w obiekcie Topic. Jeśli w masce aktualizacji znajduje się pole, które nie obsługuje pustych wartości, i nie jest ono ustawione w obiekcie Topic, zwracany jest błąd INVALID_ARGUMENT.

Możesz określić te pola:

  • name

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