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 separada por vírgulas de até 50 IDs 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 revisão por um moderador.
  • published – limpa um comentário para exibição pública. Não é possível mudar o status de moderação de um comentário rejeitado para published.
  • rejected – rejeita um comentário como inadequado para exibição. Essa ação também oculta todas as respostas ao comentário rejeitado. Para remover um comentário criado por outro usuário do seu canal ou vídeo, defina o status de moderação como rejected. O método comments.delete só pode ser usado pelo autor original do comentário.
Parâmetros opcionais
banAuthor boolean
O parâmetro banAuthor permite indicar que você quer rejeitar automaticamente outros comentários escritos pelo autor do comentário. Defina o valor do parâmetro como true para banir o autor.

Esse parâmetro só é válido se o parâmetro moderationStatus também estiver 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 as 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 Os comentários não baseados no Google+ oferecem apenas funcionalidade de moderação limitada.
badRequest (400) processingFailure O servidor de API não conseguiu processar a solicitação. Embora esse possa ser um erro temporário, ele geralmente indica que a entrada da solicitação é inválida. Esse erro também é retornado ao tentar moderar um comentário que já foi excluído pelo comentarista original.
forbidden (403) forbidden O status de moderação de um ou mais comentários não pode ser definido devido a permissões insuficientes. A solicitação pode não estar autorizada. Esse erro também é retornado ao tentar moderar um ID de comentário excluído ou inválido.
notFound (404) commentNotFound Um ou mais 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 essa API e conferir a solicitação e a resposta da API.