Method: courses.announcements.patch

Zaktualizuje co najmniej 1 pole ogłoszenia.

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

  • PERMISSION_DENIED jeśli projekt dewelopera, który wysłał prośbę, nie utworzył odpowiedniego ogłoszenia, lub z powodu błędów dostępu.
  • INVALID_ARGUMENT jeśli żądanie ma nieprawidłowy format.
  • FAILED_PRECONDITION, jeśli prośba dotyczy ogłoszenia, które zostało już usunięte.
  • NOT_FOUND, jeśli żądany kurs lub komunikat 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 kursu. Identyfikatorem może 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. Jeśli podasz nieprawidłowe pola, aktualizacja się nie powiedzie. Jeśli pole obsługuje puste wartości, można je wyczyścić, określając je w masce aktualizacji, a nie w obiekcie Announcement. Jeśli w masce aktualizacji znajduje się pole, które nie obsługuje pustych wartości, i nie jest ono określone w obiekcie Announcement, zwracany jest błąd INVALID_ARGUMENT.

Nauczyciele mogą określić te pola:

  • text
  • state
  • scheduledTime

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