LiveChatBans

Una risorsa liveChatBan identifica un utente di YouTube e una chat dal vivo di YouTube a cui è stato escluso dalla partecipazione.

Metodi

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

inserire
Escludi un utente specifico dalla sua partecipazione alla chat dal vivo. La richiesta dell'API deve essere autorizzata dal proprietario del canale o da un moderatore della chat dal vivo associata all'esclusione. Prova subito.
elimina
Rimuove l'esclusione che impedisce a un utente specifico di contribuire a una chat dal vivo e consente di nuovo di partecipare alla chat. La richiesta dell'API deve essere autorizzata dal proprietario del canale o da un moderatore della chat dal vivo associata all'esclusione. 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à che vengono 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 divieto.
snippet object
L'oggetto snippet identifica l'utente escluso e contiene i dettagli relativi all'esclusione.
snippet.liveChatId string
La chat dal vivo a cui si applica il divieto. L'ID della chat dal vivo associato a una trasmissione viene restituito nella proprietà snippet.liveChatId della risorsa liveBroadcast.
snippet.type string
Il tipo di esclusione.

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 esclusione è temporary. Il valore predefinito è 300 (5 minuti).
snippet.bannedUserDetails object
Questo oggetto contiene informazioni che identificano l'utente escluso.
snippet.bannedUserDetails.channelId string
L'ID del canale YouTube dell'utente escluso.