LiveChatBans

Eine liveChatBan-Ressource identifiziert einen YouTube-Nutzer und einen YouTube-Livechat, an dem der Nutzer nicht teilnehmen darf.

Methoden

Die API unterstützt die folgenden Methoden für liveChatBans-Ressourcen:

insert
Ein bestimmter Nutzer wird vom Livechat ausgeschlossen. Die API-Anfrage muss vom Kanalinhaber oder einem Moderator des Livechats autorisiert werden, der mit der Sperrung verknüpft ist. Hier kannst du die Funktion ausprobieren.
Delete
Entfernt eine Sperrung, die einen bestimmten Nutzer daran hindert, in einem Livechat mitzuwirken. Dadurch kann der Nutzer wieder am Chat teilnehmen. Die API-Anfrage muss vom Kanalinhaber oder einem Moderator des Livechats autorisiert werden, der mit der Sperrung verknüpft ist. Hier kannst du die Funktion ausprobieren.

Ressourcendarstellung

Die folgende JSON-Struktur zeigt das Format einer liveChatBans-Ressource:

{
  "kind": "youtube#liveChatBan",
  "etag": etag,
  "id": string,
  "snippet": {
    "liveChatId": string,
    "type": string,
    "banDurationSeconds": unsigned long,
    "bannedUserDetails": {
      "channelId": string
    }
  }
}

Attribute

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die in dieser Ressource angezeigt werden:

Attribute
kind string
Identifiziert den Typ der API-Ressource. Der Wert ist youtube#liveChatBan.
etag etag
Das Etag dieser Ressource.
id string
Die von YouTube zugewiesene ID, mit der die Sperrung eindeutig identifiziert wird.
snippet object
Das snippet-Objekt identifiziert den gesperrten Nutzer und enthält Details zur Sperrung.
snippet.liveChatId string
Der Livechat, auf den sich das Verbot bezieht. Die mit einem Livestream verknüpfte Livechat-ID wird in der Property snippet.liveChatId der liveBroadcast-Ressource zurückgegeben.
snippet.type string
Art der Sperrung.

Gültige Werte für dieses Attribut sind:
  • permanent
  • temporary
snippet.banDurationSeconds unsigned long
Die Dauer der Sperrung. Legen Sie nur dann einen Wert für diese Property fest, wenn der Typ der Sperrung temporary ist. Der Standardwert ist 300 (5 Minuten).
snippet.bannedUserDetails object
Dieses Objekt enthält Informationen, anhand derer der gesperrte Nutzer identifiziert werden kann.
snippet.bannedUserDetails.channelId string
Die YouTube-Kanal-ID des gesperrten Nutzers.