Elimina un messaggio chat. La richiesta API deve essere autorizzata dal proprietario del canale o da un moderatore della chat live associata al ban.
Impatto sulla quota: una chiamata a questo metodo ha un costo della quota di 20 unità.
Casi d'uso comuni
Richiesta
Richiesta HTTP
DELETE https://www.googleapis.com/youtube/v3/liveChat/messages
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
La tabella seguente elenca i parametri supportati da questa query. Tutti i parametri elencati sono parametri di query.
| Parametri | ||
|---|---|---|
| Parametri obbligatori | ||
id |
stringIl parametro id specifica l'ID del messaggio chat di YouTube della risorsa che viene eliminata. |
|
Corpo della richiesta
Non fornire un corpo della richiesta quando chiami questo metodo.
Risposta
Se l'operazione va a buon fine, 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 |
Non hai le autorizzazioni necessarie per eliminare il messaggio specificato. |
forbidden (403) |
modificationNotAllowed |
La risorsa liveChatMessage specificata non può essere eliminata. Il parametro id potrebbe identificare un messaggio creato da un moderatore o da un altro utente i cui messaggi non possono essere eliminati. |
notFound (404) |
liveChatMessageNotFound |
Impossibile trovare il messaggio che stai tentando di eliminare. Controlla il valore del parametro id per assicurarti che sia corretto. |
Prova
Utilizza APIs Explorer per chiamare questa API e visualizzare la richiesta API e la risposta.