Remove um banimento que impede que um usuário específico contribua para um chat ao vivo, permitindo que ele volte a participar do chat. A solicitação de API precisa ser autorizada pelo proprietário do canal ou por um moderador do chat ao vivo associado ao banimento.
Casos de uso comuns
Solicitação
Solicitação HTTP
DELETE https://www.googleapis.com/youtube/v3/liveChat/bans
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 |
string O parâmetro id identifica a proibição do chat a ser removida. O valor identifica exclusivamente o banimento 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 retorna um código de resposta HTTP 204
(No Content
).
Erros
A tabela a seguir identifica mensagens de erro que a API pode retornar em resposta a uma chamada para esse método. Consulte a documentação mensagem de erro para mais detalhes.
Tipo de erro | Detalhe do erro | Descrição |
---|---|---|
forbidden (403) |
forbidden |
O banimento especificado não pode ser removido. Esse erro pode ocorrer se a solicitação for autorizada por um moderador que está tentando remover o banimento 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 |
Não foi possível encontrar a proibição especificada. |
Confira!
Use o APIs Explorer para chamar essa API e conferir a solicitação e a resposta da API.