Implementação: classificações

Os exemplos a seguir mostram como usar a API de dados do YouTube (v3) para executar funções relacionadas às classificações de vídeo.

Avaliar um vídeo

Chame o método videos.rate para enviar a classificação de um usuário para um vídeo. Esta solicitação precisa ser autorizada usando o OAuth 2.0.

Defina os dois parâmetros a seguir na sua solicitação:

  • O parâmetro id especifica o ID do vídeo do YouTube que está sendo avaliado (ou tendo a classificação removida).
  • O parâmetro rating especifica a classificação que o usuário que autoriza a solicitação quer registrar. Os valores de parâmetro válidos são like, dislike e none. Os dois primeiros valores definem uma classificação e o terceiro remove qualquer classificação que já existia para o usuário.

O exemplo de solicitação abaixo atribui uma classificação positiva (gostei) ao vídeo do discurso de abertura na conferência Google I/O 2014:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate?
        id=wtLJPvx7-ys
        &rating=like

Recuperar a avaliação do usuário atual de um vídeo

O método videos.getRating permite recuperar a classificação de um ou mais vídeos do usuário autenticado no momento. Na sua solicitação, defina o valor do parâmetro id como uma lista separada por vírgulas de IDs de vídeos do YouTube para os recursos para os quais você está recuperando dados de classificação. Observe que essa solicitação precisa ser autorizada usando o OAuth 2.0.

O exemplo de solicitação abaixo recupera a classificação do usuário atual em relação ao vídeo da palestra de abertura da conferência Google I/O 2014. Se você executou o exemplo anterior no APIs Explorer, a resposta da API vai indicar que a classificação é like.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating?
id=wtLJPvx7-ys

Recuperar vídeos avaliados pelo usuário atual

O parâmetro myRating do método videos.list permite recuperar uma lista de vídeos avaliados pelo usuário que autorizou a solicitação de API. O valor do parâmetro indica se você quer recuperar vídeos marcados como "Gostei" ou "Não gostei".

O exemplo de solicitação abaixo recupera uma lista de vídeos para os quais o usuário atual deu uma classificação like. A solicitação precisa ser autorizada usando o OAuth 2.0.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
part=snippet
&myRating=like
Observação: também é possível recuperar uma lista de vídeos marcados com "Gostei" (mas não de vídeos não gostei) seguindo o fluxo para recuperar os vídeos favoritos de um canal. Na etapa 1 desse processo, em vez de recuperar o ID da playlist dos vídeos favoritos do canal, recupere o ID da playlist dos vídeos marcados com "Gostei". A propriedade contentDetails.relatedPlaylists.likes contém o valor.

Assim, a API permite que você recupere uma lista de vídeos que o usuário gostou usando os métodos videos.list ou playlistItems.list. Como são retornadas informações diferentes em um recurso video e em um recurso playlistItem, você pode escolher o método que melhor atenda às suas necessidades.