Define o status de moderação de um ou mais comentários. A solicitação de API precisa ser autorizada pelo proprietário do canal ou vídeo associado aos comentários.
Impacto na cota: uma chamada para esse método tem um custo de cota de 50 unidades.
Casos de uso comuns
Solicitação
Solicitação HTTP
POST https://www.googleapis.com/youtube/v3/comments/setModerationStatus
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.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 especifica uma lista de IDs separados por vírgulas que identificam os comentários para os quais você está atualizando o status de moderação. |
|
moderationStatus |
string Identifica o novo status de moderação dos comentários especificados. Os valores aceitáveis são:
|
|
Parâmetros opcionais | ||
banAuthor |
boolean O parâmetro banAuthor permite indicar que você quer rejeitar automaticamente qualquer comentário adicional escrito pelo autor do comentário. Defina o valor do parâmetro como true para banir o autor.Observação:esse parâmetro só será válido se o parâmetro moderationStatus também for definido como rejected . |
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 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 |
---|---|---|
badRequest (400) |
banWithoutReject |
O parâmetro banAuthor só pode ser usado se o valor do parâmetro moderationStatus for rejected . |
badRequest (400) |
operationNotSupported |
Comentários não baseados no Google+ oferecem apenas funcionalidade limitada de moderação. |
badRequest (400) |
processingFailure |
O servidor da API falhou ao processar a solicitação. Embora isso possa ser um erro temporário, geralmente indica que a entrada da solicitação é inválida. |
forbidden (403) |
forbidden |
Não é possível definir o status de moderação de um ou mais comentários devido a permissões insuficientes. A solicitação pode não es devidamente autorizada. |
notFound (404) |
commentNotFound |
Um ou mais dos comentários que a solicitação está tentando atualizar não foram encontrados. Verifique os valores do parâmetro id da solicitação para garantir que eles estejam corretos. |
Confira!
Use o APIs Explorer para chamar a API e conferir a solicitação e a resposta da API.