LiveChatBans: delete

Damit wird eine Sperre entfernt, die verhindert, dass ein bestimmter Nutzer am Livechat teilnimmt. Dadurch kann der Nutzer dem Chat wieder beitreten. Die API-Anfrage muss vom Kanalinhaber oder Moderator des mit der Sperre verknüpften Livechats autorisiert werden.

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

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

Anfragetext

Geben Sie beim Aufrufen dieser Methode keinen Anfragetext an.

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode ein HTTP-204-Antwortcode (No Content) zurückgegeben.

Fehler

In der folgenden Tabelle finden Sie Fehlermeldungen, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben könnte. 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, 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.