LiveChatBans: delete

Rimuove un ban che impedisce a un utente specifico di contribuire a una chat live, consentendogli di rientrare nella chat. La richiesta API deve essere autorizzata dal proprietario del canale o da un moderatore della chat live associata al ban.

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 dei seguenti ambiti. Per saperne di più sull'autenticazione e sull'autorizzazione, consulta Implementare l'autenticazione OAuth 2.0.

Ambito
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parametri

La tabella seguente elenca i parametri supportati da questa query. Tutti i parametri elencati sono parametri di query.

Parametri
Parametri obbligatori
id string
Il parametro id identifica il ban della chat da rimuovere. Il valore identifica in modo univoco sia il ban sia la chat.

Corpo della richiesta

Non fornire un corpo della richiesta quando chiami questo metodo.

Risposta

Se la richiesta ha esito positivo, questo metodo restituisce un codice di stato 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 il messaggio di errore.

Tipo di errore Dettagli errore Descrizione
forbidden (403) forbidden Non è possibile rimuovere il ban specificato. Questo errore può verificarsi se la richiesta è autorizzata da un moderatore che tenta di rimuovere un ban su un altro moderatore.
forbidden (403) insufficientPermissions Non disponi delle autorizzazioni necessarie per rimuovere il ban specificato.
invalidValue (400) invalidLiveChatBanId Il parametro id specifica un valore non valido.
notFound (404) liveChatBanNotFound Non è possibile trovare il ban specificato.

Prova

Utilizza APIs Explorer per chiamare questa API e visualizzare la richiesta API e la risposta.