Method: courses.announcements.delete

Löscht eine Mitteilung.

Diese Anfrage muss über das Developer Console-Projekt der OAuth-Client-ID erfolgen, die zum Erstellen des entsprechenden Mitteilungselements verwendet wurde.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn die entsprechende Ankündigung nicht vom anfragenden Entwicklerprojekt erstellt wurde, der anfragende Nutzer nicht berechtigt ist, den angeforderten Kurs zu löschen, oder bei Zugriffsfehlern.
  • FAILED_PRECONDITION, wenn die angeforderte Mitteilung bereits gelöscht wurde.
  • NOT_FOUND, wenn kein Kurs mit der angeforderten ID vorhanden ist.

HTTP-Anfrage

DELETE 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

Die ID der Ankündigung, die gelöscht werden soll. Diese Kennung wird von Classroom zugewiesen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, ist der Antworttext ein leeres JSON-Objekt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.