LiveChatBans

Eine liveChatBan-Ressource gibt einen YouTube-Nutzer und einen YouTube-Livechat an, an denen der Nutzer nicht teilnehmen kann.

Methoden

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

Einfügen
Die Teilnahme am Livechat wird für einen bestimmten Nutzer gesperrt. Die API-Anfrage muss vom Kanalinhaber oder vom Moderator des Livechats genehmigt werden, der mit der Sperre verknüpft ist. Hier kannst du die Funktion ausprobieren.
Delete
Entfernt eine Sperre, durch die verhindert wird, dass ein bestimmter Nutzer zum Livechat beiträgt. Der Nutzer kann dann wieder am Chat teilnehmen. Die API-Anfrage muss vom Kanalinhaber oder vom Moderator des Livechats genehmigt werden, der mit der Sperre 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 werden die Attribute definiert, 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 ID, die YouTube zur eindeutigen Identifizierung der Sperre zuweist.
snippet object
Das Objekt snippet identifiziert den gesperrten Nutzer und enthält Details zur Sperre.
snippet.liveChatId string
Der Livechat, für den die Sperre gilt. Die mit einer Übertragung verknüpfte Live-Chat-ID wird in der Property snippet.liveChatId der Ressource liveBroadcast zurückgegeben.
snippet.type string
Die Art der Sperre.

Gültige Werte für diese Property sind:
  • permanent
  • temporary
snippet.banDurationSeconds unsigned long
Die Dauer der Sperre. Legen Sie nur einen Wert für diese Property fest, wenn der Typ der Sperre temporary ist. Der Standardwert ist 300 (5 Minuten).
snippet.bannedUserDetails object
Dieses Objekt enthält Informationen zur Identifizierung des gesperrten Nutzers.
snippet.bannedUserDetails.channelId string
Die YouTube-Kanal-ID des gesperrten Nutzers