LiveChatMessages: delete

Löscht eine Chatnachricht. Die API-Anfrage muss vom Kanalinhaber oder vom Moderator des Livechats genehmigt werden, der mit der Sperre verknüpft ist.

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

Umfang
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 YouTube-Chatnachricht-ID 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 der HTTP-Antwortcode 204 (No Content) zurückgegeben.

Fehler

In der folgenden Tabelle sind Fehlermeldungen aufgeführt, die von der API möglicherweise als Antwort auf einen Aufruf dieser Methode zurückgegeben werden. 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 zu löschen versuchen, wurde nicht gefunden. Prüfen Sie, ob der Wert des Parameters id korrekt ist.

Testen!

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