Videos: rate

Adiciona uma classificação gostei ou não gostei a um vídeo ou remove uma classificação de um vídeo.

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/videos/rate

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/youtubepartner
https://www.googleapis.com/auth/youtube
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
id string
O parâmetro id especifica o ID do vídeo do YouTube que está sendo avaliado ou que teve a classificação removida.
rating string
Especifica a classificação a ser registrada.

Os valores aceitáveis são os seguintes:
  • dislike – Registra que o usuário autenticado não gostou do vídeo.
  • like – Registra que o usuário autenticado gostou do vídeo.
  • none – Remove qualquer avaliação que o usuário autenticado tenha definido anteriormente para o vídeo.

Corpo da solicitação

Não forneça um corpo de solicitação ao chamar este método.

Resposta

Se for bem-sucedido, este método retornará um código de resposta HTTP 204 (No Content).

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) emailNotVerified O usuário precisa confirmar o próprio endereço de e-mail antes da avaliação.
badRequest (400) invalidRating A solicitação continha um valor inesperado para o parâmetro rating.
badRequest (400) videoPurchaseRequired Os vídeos para locação só podem ser avaliados por usuários que os alugaram.
forbidden (403) forbidden O vídeo que você está tentando classificar não pode ser classificado. A solicitação pode não es devidamente autorizada.
forbidden (403) videoRatingDisabled O proprietário do vídeo que você está tentando classificar desativou as classificações desse vídeo.
notFound (404) videoNotFound O vídeo que você está tentando classificar não pode ser encontrado. Verifique o valor do parâmetro id da solicitação para garantir que ele esteja correto.

Confira!

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