Comments: setModerationStatus

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:
  • heldForReview: marca um comentário como aguardando a revisão de um moderador.
  • published: limpa um comentário para exibição pública.
  • rejected: rejeita um comentário como inadequado para exibição. Essa ação também oculta todas as respostas ao comentário rejeitado.
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.