LiveChatBans: delete

Entfernt eine Sperre, die verhindert, dass ein bestimmter Nutzer zu einem Livechat beiträgt, sodass er dem Chat wieder beitreten kann. Die API-Anfrage muss vom Kanalinhaber oder Moderator des Livechats autorisiert 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

Für diese Anfrage ist eine Autorisierung mit mindestens einem der folgenden Bereiche erforderlich. Weitere Informationen zur Authentifizierung und Autorisierung findest du 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. Mit dem Wert werden die Sperre und der Chat eindeutig identifiziert.

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 Fehlermeldungen aufgeführt, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben könnte. Weitere Informationen finden Sie unter Fehlermeldung.

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) forbidden Die angegebene Sperre kann nicht entfernt werden. Dieser Fehler kann auftreten, wenn die Anfrage von einem Moderator genehmigt wurde, der versucht, die 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.

Jetzt testen

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