Comments: update

Modifica um comentário.

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

PUT 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. É necessário incluir pelo menos a parte snippet no valor do parâmetro, já que ela contém todas as propriedades que a solicitação de API pode atualizar.

A lista a seguir contém os nomes 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:

  • 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) commentTextTooLong O recurso comment que está sendo atualizado contém muitos caracteres na propriedade snippet.textOriginal.
badRequest (400) invalidCommentMetadata Os metadados da solicitação são inválidos.
badRequest (400) operationNotSupported Somente comentários baseados no Google+ podem ser atualizados.
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 atualizar 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 atualizar um comentário ou uma sequência de comentários.
notFound (404) commentNotFound Não foi possível encontrar o comentário especificado. Verifique o valor da propriedade id 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.