Implementação: classificações

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

Avaliar um vídeo

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

Defina estes dois parâmetros na solicitação:

  • O parâmetro id especifica o ID do vídeo do YouTube que está sendo avaliado ou que teve 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 avaliação que já existia para o usuário.

O exemplo de solicitação abaixo é classificado de forma positiva (como) no vídeo da palestra 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 classificação do usuário atual de um vídeo

O método videos.getRating permite recuperar a classificação do usuário autenticado atualmente em um ou mais vídeos. Na solicitação, defina o valor do parâmetro id como uma lista separada por vírgulas dos IDs dos vídeos do YouTube para os recursos para os quais você está recuperando dados de classificação. 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 do vídeo da palestra de abertura na conferência Google I/O 2014. Se você executou o exemplo anterior no APIs Explorer, a resposta da API precisa indicar que a classificação é like.

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

Recuperar vídeos classificados pelo usuário atual

O parâmetro myRating do método videos.list permite recuperar uma lista de vídeos classificados pelo usuário que está autorizando a solicitação de API. O valor do parâmetro indica se você quer recuperar vídeos marcados com "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: você também pode recuperar uma lista dos vídeos marcados com "Gostei" do usuário (mas não marcados como "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 referente aos vídeos favoritos do canal, recupere o ID da playlist dos vídeos marcados com "Gostei" do canal. A propriedade contentDetails.relatedPlaylists.likes contém o valor.

A API permite que você recupere uma lista de vídeos que o usuário gostou usando o método videos.list ou playlistItems.list. Como informações diferentes são retornadas em um recurso video do que em um playlistItem, é possível escolher o método mais adequado às suas necessidades.