LiveChatMessages: delete

Löscht eine Chatnachricht. Die API-Anfrage muss vom Kanalinhaber oder Moderator des mit der Sperre verknüpften Livechats autorisiert werden.

Gängige Anwendungsfälle

Anfragen

HTTP-Anfrage

DELETE https://www.googleapis.com/youtube/v3/liveChat/messages

Autorisierung

Diese Anfrage benötigt eine Autorisierung mit mindestens einem der folgenden Bereiche (weitere Informationen zu Authentifizierung und Autorisierung).

Bereich
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parameter

In der folgenden Tabelle sind die Parameter aufgeführt, die von dieser Abfrage unterstützt werden. Alle aufgeführten Parameter sind Abfrageparameter.

Parameter
Erforderliche Parameter
id string
Der Parameter id gibt die Nachrichten-ID der YouTube-Chatnachricht der Ressource an, die gelöscht wird.

Anfragetext

Geben Sie beim Aufrufen dieser Methode keinen Anfragetext an.

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode ein HTTP-204-Antwortcode (No Content) zurückgegeben.

Fehler

In der folgenden Tabelle finden Sie Fehlermeldungen, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben könnte. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) forbidden Sie sind nicht berechtigt, die angegebene Nachricht zu löschen.
forbidden (403) modificationNotAllowed Die angegebene liveChatMessage-Ressource kann nicht gelöscht werden. Der Parameter id kann eine Nachricht identifizieren, die von einem Moderator oder einem anderen Nutzer erstellt wurde, dessen Nachrichten nicht gelöscht werden können.
notFound (404) liveChatMessageNotFound Die Nachricht, die Sie löschen möchten, wurde nicht gefunden. Prüfen Sie, ob der Wert des Parameters id korrekt ist.

Jetzt testen

Verwenden Sie APIs Explorer, um diese API aufzurufen und die API-Anfrage und -Antwort anzusehen.