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:
|
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. |