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 da 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 marcações "Gostei" e "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 avaliado ou 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 classificação que o usuário autenticado definiu 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 retorna 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 verificar o endereço de e-mail antes de fazer a classificação.
badRequest (400) invalidRating A solicitação continha um valor inesperado para o parâmetro rating.
badRequest (400) videoPurchaseRequired Os vídeos disponíveis para locação podem ser avaliados somente pelos 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 avaliar 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 está correto.

Confira!

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