Comments: insert

Cria uma resposta a um comentário existente. Observação:para criar um comentário de nível superior, use o método commentThreads.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/comments

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 duas unidades.

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

Corpo da solicitação

Forneça um recurso de comentário no corpo da solicitação. Para esse recurso:

  • É necessário especificar um valor para essas propriedades:

    • snippet.textOriginal
    • snippet.parentId

  • Você pode definir valores para estas propriedades:

    • snippet.textOriginal

Resposta

Se for bem-sucedido, este método retornará um recurso de comentário 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. Consulte a documentação mensagem de erro para mais detalhes.

Tipo de erro Detalhe do erro Descrição
badRequest (400) commentTextRequired O recurso comment que está sendo inserido precisa especificar um valor para a propriedade snippet.textOriginal. Os comentários não podem ficar vazios.
badRequest (400) commentTextTooLong O recurso comment que está sendo inserido contém muitos caracteres na propriedade snippet.textOriginal.
badRequest (400) invalidCustomEmoji O recurso comment que está sendo inserido contém emojis personalizados inválidos.
badRequest (400) invalidCommentMetadata Os metadados da solicitação são inválidos.
badRequest (400) operationNotSupported O usuário da API não consegue inserir um comentário em resposta ao comentário de nível superior identificado pela propriedade snippet.parentId. Em um recurso commentThread, a propriedade snippet.canReply indica se o visualizador atual pode responder à linha de execução.
badRequest (400) parentCommentIsPrivate O comentário pai especificado é particular. A API não oferece suporte a respostas a comentários particulares.
badRequest (400) parentIdMissing O comentário que está sendo inserido deve estar vinculado a um comentário pai. No entanto, o recurso comment no corpo da solicitação de API não especificou um valor para a propriedade snippet.parentId.
badRequest (400) processingFailure O servidor da API não conseguiu processar a solicitação. Embora esse erro possa ser temporário, ele geralmente indica que a entrada da solicitação é inválida. Verifique a estrutura do recurso comment no corpo da solicitação para garantir que ele seja válido.
forbidden (403) forbidden Não foi possível criar o comentário 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 à Conta do Google do usuário para inserir um comentário ou sequência de comentários.
notFound (404) parentCommentNotFound Não foi possível encontrar o comentário pai especificado. Verifique o valor da propriedade snippet.parentId no corpo da solicitação para garantir que ela esteja correta.

Confira!

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