CommentThreads: insert

Cria um novo comentário de nível superior. Para adicionar uma resposta a um comentário existente, use o método comments.insert.

Impacto da 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/commentThreads

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
part string
O parâmetro part identifica as propriedades que serão incluídas na resposta da API. Defina o valor do parâmetro como snippet. A parte snippet tem um custo de cota de 2 unidades.

A lista a seguir contém os nomes de part que podem ser incluídos no valor do parâmetro:
  • id
  • replies
  • snippet

Corpo da solicitação

Forneça um recursocommentThread no corpo da solicitação.

Para esse recurso, especifique um valor para as seguintes propriedades:

  • snippet.channelId
  • snippet.videoId
  • snippet.topLevelComment.snippet.textOriginal

Resposta

Se for bem-sucedido, esse método retornará um recursocommentThread no corpo da resposta.

Erros

A tabela a seguir identifica mensagens de erro que a API pode retornar em resposta a uma chamada para esse método. Para mais detalhes, consulte a documentação mensagem de erro.

Tipo de erro Detalhe do erro Descrição
badRequest (400) channelOrVideoIdMissing Cada conversa precisa estar vinculada a um vídeo. Confira se o recurso especifica valores para as propriedades snippet.channelId e snippet.videoId. Um comentário em um vídeo aparece na página de exibição do vídeo.
badRequest (400) commentTextRequired O recurso comment que está sendo inserido precisa especificar um valor para a propriedade snippet.topLevelComment.snippet.textOriginal. Os comentários não podem ficar em branco.
badRequest (400) commentTextTooLong O recurso comment que está sendo inserido contém muitos caracteres na propriedade snippet.topLevelComment.snippet.textOriginal.
badRequest (400) invalidCommentThreadMetadata Os metadados da solicitação são inválidos.
badRequest (400) processingFailure O servidor da API falhou ao processar a solicitação. Embora possa ser um erro temporário, ele geralmente indica que a entrada da solicitação é inválida. Verifique a estrutura do recurso commentThread no corpo da solicitação para garantir que ele é válido.
forbidden (403) forbidden Não foi possível criar a conversa de comentários porque não há permissões suficientes. A solicitação pode não es devidamente autorizada.
forbidden (403) ineligibleAccount A conta do YouTube usada para autorizar a solicitação de API deve ser mesclada com a Conta do Google do usuário para inserir um comentário ou uma sequência de comentários.
notFound (404) channelNotFound Não foi possível encontrar o canal especificado. Verifique o valor da propriedade snippet.channelId para garantir que ele está correto.
notFound (404) videoNotFound Não foi possível encontrar o vídeo especificado. Verifique o valor da propriedade snippet.videoId para garantir que ele está correto.

Confira!

Use o APIs Explorer para chamar essa API e conferir a solicitação e a resposta da API.