Rimuove un'esclusione che impedisce a un utente specifico di contribuire a una chat live, consentendogli di partecipare di nuovo alla chat. La richiesta API deve essere autorizzata dal proprietario del canale o da un moderatore della chat live associata all'esclusione.
Casi d'uso comuni
Richiesta
Richiesta HTTP
DELETE https://www.googleapis.com/youtube/v3/liveChat/bans
Autorizzazione
Questa richiesta richiede l'autorizzazione con almeno uno degli ambiti seguenti. Per scoprire di più sull'autenticazione e sull'autorizzazione, consulta Implementazione dell'autenticazione OAuth 2.0.
Ambito |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parametri
La seguente tabella elenca i parametri supportati da questa query. Tutti i parametri elencati sono parametri di query.
Parametri | ||
---|---|---|
Parametri obbligatori | ||
id |
string Il parametro id identifica l'esclusione della chat da rimuovere. Il valore identifica in modo univoco sia l'esclusione sia la chat. |
Corpo della richiesta
Non fornire un corpo della richiesta quando chiami questo metodo.
Risposta
Se l'esito è positivo, questo metodo restituisce un codice di stato HTTP 204 No Content
.
Errori
La seguente tabella identifica i messaggi di errore che l'API potrebbe restituire in risposta a una chiamata a questo metodo. Per maggiori dettagli, consulta il messaggio di errore.
Tipo di errore | Dettagli dell'errore | Descrizione |
---|---|---|
forbidden (403) |
forbidden |
L'esclusione specificata non può essere rimossa. Questo errore può verificarsi se la richiesta è autorizzata da un moderatore che sta tentando di rimuovere l'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 l'esclusione specificata. |
Prova.
Usa APIs Explorer per chiamare questa API e visualizzare la richiesta e la risposta API.