LiveChatMessages: delete

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

Auswirkungen auf das Kontingent: Ein Aufruf dieser Methode hat Kontingentkosten von 20 Einheiten.

Gängige Anwendungsfälle

Anfrage

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 YouTube-Chatnachrichten-ID der Ressource an, die gelöscht wird.

Anfragetext

Geben Sie beim Aufrufen dieser Methode keinen Anfragetext an.

Antwort

Bei Erfolg gibt diese Methode den HTTP-Antwortcode 204 (No Content) zurück.

Fehler

In der folgenden Tabelle sind die Fehlermeldungen aufgeführt, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben kann. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp Fehlerdetail Beschreibung
forbidden (403) forbidden Sie haben nicht die erforderlichen Berechtigungen, um 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 den Wert des Parameters id und stellen Sie sicher, dass er korrekt ist.

Testen!

Mit dem APIs Explorer können Sie diese API aufrufen und die API-Anfrage und -Antwort ansehen.