LiveChatBans: delete

Entfernt eine Sperre, die verhindert, dass ein bestimmter Nutzer zu einem Livechat beiträgt. Der Nutzer kann dann wieder am Chat teilnehmen. 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/bans

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 zu entfernende Chatsperre an. Der Wert identifiziert sowohl die Sperre als auch den Chat eindeutig.

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 Die angegebene Sperre kann nicht entfernt werden. Dieser Fehler kann auftreten, wenn die Anfrage von einem Moderator autorisiert wurde, der versucht, eine Sperre eines anderen Moderators aufzuheben.
forbidden (403) insufficientPermissions Sie sind nicht berechtigt, die angegebene Sperre zu entfernen.
invalidValue (400) invalidLiveChatBanId Der Parameter id gibt einen ungültigen Wert an.
notFound (404) liveChatBanNotFound Die angegebene Sperre wurde nicht gefunden.

Testen!

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