Method: courses.announcements.patch

Aktualizuje jedno lub więcej pól ogłoszenia.

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

  • PERMISSION_DENIED, jeśli projekt dewelopera, który wysłał prośbę, nie utworzył odpowiedniego ogłoszenia lub wystąpiło błędy dostępu.
  • INVALID_ARGUMENT, jeśli żądanie jest uszkodzone.
  • FAILED_PRECONDITION, jeśli to ogłoszenie zostało już usunięte.
  • NOT_FOUND, jeśli kurs lub ogłoszenie nie istnieje

Żądanie HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{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 ogłoszenia.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Maska określająca, które pola w ogłoszeniu 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 ogłoszenia. Jeśli w masce aktualizacji uwzględnione jest pole, które nie obsługuje pustych wartości, ale nie jest ustawione w obiekcie ogłoszenia, zwracany jest błąd INVALID_ARGUMENT.

Nauczyciele mogą określić te pola:

  • text
  • state
  • scheduledTime

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

Treść odpowiedzi

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w przewodniku po autoryzacji.