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.

OBSERVAÇÃO:isso não afeta a contagem oficial de gostei/não gostei do vídeo.

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 classificado ou cuja classificação está sendo removida.
rating string
Especifica a classificação a ser registrada.

Os valores aceitáveis são:
  • 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 classificaçã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, esse método retornará um código de resposta HTTP 204 (No Content).

Erros

A tabela a seguir identifica as 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 verificar o endereço de e-mail antes de classificar.
badRequest (400) invalidRating A solicitação continha um valor inesperado para o parâmetro rating.
badRequest (400) videoPurchaseRequired Os vídeos alugados só podem ser classificados 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 para esse 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 essa API e conferir a solicitação e a resposta da API.