Exclui uma mensagem de chat. A solicitação de API precisa ser autorizada pelo proprietário do canal ou por um moderador do chat ao vivo associado à proibição.
Impacto na cota:uma chamada para esse método tem um custo de cota de 20 unidades.
Casos de uso comuns
Solicitação
Solicitação HTTP
DELETE https://www.googleapis.com/youtube/v3/liveChat/messages
Autorização
Esta solicitação requer autorização com pelo menos um dos seguintes escopos (leia mais sobre autenticação e autorização).
| Escopo |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parâmetros
A tabela a seguir lista os parâmetros compatíveis com essa consulta. Todos os parâmetros listados são os parâmetros de consulta.
| Parâmetros | ||
|---|---|---|
| Parâmetros obrigatórios | ||
id |
stringO parâmetro id especifica o ID da mensagem de chat do YouTube do recurso que está sendo excluído. |
|
Corpo da solicitação
Não forneça um corpo de solicitação ao chamar este método.
Resposta
Se for bem-sucedido, esse método retornará um código de resposta HTTP 204 (No Content).
Erros
A tabela a seguir identifica as mensagens de erro que a API pode retornar em resposta a uma chamada para esse método. Consulte a documentação da mensagem de erro para mais detalhes.
| Tipo de erro | Detalhe do erro | Descrição |
|---|---|---|
forbidden (403) |
forbidden |
Você não tem as permissões necessárias para excluir a mensagem especificada. |
forbidden (403) |
modificationNotAllowed |
Não é possível excluir o recurso liveChatMessage especificado. O parâmetro id pode identificar uma mensagem criada por um moderador ou outro usuário cujas mensagens não podem ser excluídas. |
notFound (404) |
liveChatMessageNotFound |
Não foi possível encontrar a mensagem que você está tentando excluir. Verifique se o valor do parâmetro id está correto. |
Confira!
Use o APIs Explorer para chamar essa API e conferir a solicitação e a resposta da API.