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.