Remove uma proibição que impede um usuário específico de contribuir com um chat ao vivo, permitindo que ele participe novamente. A solicitação de API precisa ser autorizada pelo proprietário do canal ou por um moderador do chat ao vivo associado à proibição.
Casos de uso comuns
Solicitação
Solicitação HTTP
DELETE https://www.googleapis.com/youtube/v3/liveChat/bans
Autorização
Essa solicitação exige autorização com pelo menos um dos escopos a seguir. Para saber mais sobre autenticação e autorização, consulte Implementar a autenticação do OAuth 2.0.
| 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 que essa consulta aceita. Todos os parâmetros listados são os parâmetros de consulta.
| Parâmetros | ||
|---|---|---|
| Parâmetros obrigatórios | ||
id |
stringO parâmetro id identifica a proibição de chat a ser removida. O valor identifica de forma exclusiva a proibição e o chat. |
|
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 vai retornar um código de status 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. Para mais detalhes, consulte Mensagem de erro.
| Tipo de erro | Detalhe do erro | Descrição |
|---|---|---|
forbidden (403) |
forbidden |
A proibição especificada não pode ser removida. Esse erro pode ocorrer se a solicitação for autorizada por um moderador que está tentando remover uma proibição de outro moderador. |
forbidden (403) |
insufficientPermissions |
Você não tem as permissões necessárias para remover a proibição especificada. |
invalidValue (400) |
invalidLiveChatBanId |
O parâmetro id especifica um valor inválido. |
notFound (404) |
liveChatBanNotFound |
A proibição especificada não foi encontrada. |
Confira!
Use o APIs Explorer para chamar essa API e conferir a solicitação de API e a resposta.