LiveChatBans: delete

Entfernt eine Sperre, die verhindert, dass ein bestimmter Nutzer zu einem Live-Chat beiträgt. Dadurch kann der Nutzer dem Chat wieder beitreten. Die API-Anfrage muss vom Kanalinhaber oder einem Moderator des Live-Chats autorisiert werden, der mit der Sperre verknüpft ist.

Gängige Anwendungsfälle

Anfrage

HTTP-Anfrage

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

Autorisierung

Für diese Anfrage ist eine Autorisierung mit mindestens einem der folgenden Bereiche erforderlich. Weitere Informationen zur Authentifizierung und Autorisierung finden Sie unter OAuth 2.0-Authentifizierung implementieren.

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

Bei Erfolg gibt diese Methode den HTTP-Statuscode 204 No Content zurück.

Fehler

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

Fehlertyp Fehlerdetail Beschreibung
forbidden (403) forbidden Die angegebene Sperre kann nicht entfernt werden. Dieser Fehler kann auftreten, wenn die Anfrage von einem Moderator autorisiert wird, der versucht, eine Sperre für einen anderen Moderator zu entfernen.
forbidden (403) insufficientPermissions Sie haben nicht die erforderlichen Berechtigungen, um 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!

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