CommentThreads: insert

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

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/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 a resposta da API vai incluir. 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 part que podem ser incluídos no valor do parâmetro:
  • id
  • replies
  • snippet

Corpo da solicitação

Forneça um recurso commentThread 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 vai retornar um recurso commentThread no corpo da resposta.

Erros

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

Tipo de erro Detalhe do erro Descrição
badRequest (400) channelOrVideoIdMissing Cada conversa de comentários precisa estar vinculada a um vídeo. Verifique 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 estar vazios.
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 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. Verifique a estrutura do recurso commentThread no corpo da solicitação para garantir que ele seja válido.
forbidden (403) forbidden Não foi possível criar a conversa de comentários devido a permissões insuficientes. A solicitação pode não es devidamente autorizada.
forbidden (403) ineligibleAccount A conta do YouTube usada para autorizar a solicitação de API precisa ser mesclada com a Conta do Google do usuário para inserir um comentário ou uma conversa de comentários.
notFound (404) channelNotFound Não foi possível encontrar o canal especificado. Verifique se o valor da propriedade snippet.channelId está correto.
notFound (404) videoNotFound Não foi possível encontrar o vídeo especificado. Verifique se o valor da propriedade snippet.videoId está correto.

Confira!

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