Comments: insert

Cria uma resposta para um comentário existente. Observação:para criar um comentário de nível superior, use o método commentThreads.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/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 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
  • 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 em branco.
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 leitor atual pode responder à conversa.
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 precisa 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 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 comment no corpo da solicitação para garantir que ele é válido.
forbidden (403) forbidden Não é possível criar o comentário 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 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) 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 ele esteja correto.

Confira!

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