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.