LiveChatBans

Una risorsa liveChatBan identifica un utente di YouTube e una chat live di YouTube a cui l'utente non può partecipare.

Metodi

L'API supporta i seguenti metodi per le risorse liveChatBans:

insert
Impedisce a un utente specifico di partecipare alla chat live. La richiesta API deve essere autorizzata dal proprietario del canale o da un moderatore della chat live associata al ban. Prova subito.
elimina
Rimuove un ban che impedisce a un utente specifico di contribuire a una chat live, consentendogli così di rientrare nella chat. La richiesta API deve essere autorizzata dal proprietario del canale o da un moderatore della chat live associata al ban. Prova subito.

Rappresentazione delle risorse

La seguente struttura JSON mostra il formato di una risorsa liveChatBans:

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

Proprietà

La tabella seguente definisce le proprietà visualizzate in questa risorsa:

Proprietà
kind string
Identifica il tipo di risorsa API. Il valore sarà youtube#liveChatBan.
etag etag
L'ETag di questa risorsa.
id string
L'ID assegnato da YouTube per identificare in modo univoco il ban.
snippet object
L'oggetto snippet identifica l'utente bannato e contiene i dettagli del ban.
snippet.liveChatId string
La chat live a cui si applica il divieto. L'ID chat live associato a una trasmissione viene restituito nella proprietà snippet.liveChatId della risorsa liveBroadcast.
snippet.type string
Il tipo di ban.

I valori validi per questa proprietà sono:
  • permanent
  • temporary
snippet.banDurationSeconds unsigned long
La durata dell'esclusione. Imposta un valore per questa proprietà solo se il tipo di divieto è temporary. Il valore predefinito è 300 (5 minuti).
snippet.bannedUserDetails object
Questo oggetto contiene informazioni che identificano l'utente bannato.
snippet.bannedUserDetails.channelId string
L'ID canale YouTube dell'utente bannato.