Rimuove l'esclusione che impedisce a un utente specifico di contribuire a una chat dal vivo e permette all'utente di partecipare di nuovo alla chat. La richiesta dell'API deve essere autorizzata dal proprietario del canale o da un moderatore della chat dal vivo associata all'esclusione.
Casi d'uso comuni
Risorse richieste:
Richiesta HTTP
DELETE https://www.googleapis.com/youtube/v3/liveChat/bans
Autorizzazione
Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti (scopri di più su autenticazione e autorizzazione).
Ambito |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parametri
Nella tabella seguente sono elencati i parametri supportati dalla query. Tutti i parametri elencati sono parametri di ricerca.
Parametri | ||
---|---|---|
Parametri obbligatori | ||
id |
string Il parametro id identifica l'esclusione della chat da rimuovere. Il valore identifica in modo univoco sia la esclusione che la chat. |
Corpo della richiesta
Non fornire un corpo della richiesta quando chiami questo metodo.
Risposta
In caso di esito positivo, questo metodo restituisce un codice di risposta HTTP 204
(No Content
).
Errori
La tabella seguente identifica i messaggi di errore che l'API potrebbe restituire in risposta a una chiamata a questo metodo. Per maggiori dettagli, consulta la documentazione sui messaggi di errore.
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
forbidden (403) |
forbidden |
Impossibile rimuovere l'esclusione specificata. Questo errore può verificarsi se la richiesta viene autorizzata da un moderatore che sta tentando di rimuovere un'esclusione da un altro moderatore. |
forbidden (403) |
insufficientPermissions |
Non disponi delle autorizzazioni necessarie per rimuovere l'esclusione specificata. |
invalidValue (400) |
invalidLiveChatBanId |
Il parametro id specifica un valore non valido. |
notFound (404) |
liveChatBanNotFound |
Impossibile trovare il esclusione specificato. |
Prova.
Usa APIs Explorer per chiamare questa API e visualizzare la richiesta e la risposta dell'API.