Method: courses.announcements.patch

Aktualisiert ein oder mehrere Felder einer Mitteilung.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn die entsprechende Mitteilung nicht vom anfragenden Entwicklerprojekt erstellt wurde, oder bei Zugriffsfehlern.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • FAILED_PRECONDITION, wenn die angeforderte Mitteilung bereits gelöscht wurde.
  • NOT_FOUND, wenn der angeforderte Kurs oder die angeforderte Mitteilung nicht existiert

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

Kennung des Kurses. Diese Kennung kann entweder die in Classroom zugewiesene Kennung oder eine alias sein.
id

string

Kennung der Mitteilung.

Abfrageparameter

Parameter
updateMask

string (FieldMask format)

Maske, mit der angegeben wird, welche Felder in der Mitteilung aktualisiert werden sollen. Dieses Feld ist für eine Aktualisierung erforderlich. Die Aktualisierung schlägt fehl, wenn ungültige Felder angegeben werden. Wenn ein Feld leere Werte unterstützt, kann es gelöscht werden, indem es in der Aktualisierungsmaske und nicht im Ansageobjekt angegeben wird. Wenn ein Feld, das keine leeren Werte unterstützt, in der Aktualisierungsmaske enthalten ist und nicht im Ansageobjekt festgelegt ist, wird der Fehler INVALID_ARGUMENT zurückgegeben.

Die folgenden Felder können von Lehrkräften angegeben werden:

  • text
  • state
  • scheduledTime

Dies ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo".

Anfragetext

Der Anfragetext enthält eine Instanz von Announcement.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Announcement.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.