Implementação: classificações

Os exemplos a seguir mostram como usar a API Data do YouTube (v3) para realizar 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. Essa solicitação precisa ser autorizada usando o OAuth 2.0.

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

  • O parâmetro id especifica o ID do vídeo do YouTube que está sendo classificado (ou que teve a classificação removida).
  • O parâmetro rating especifica a nota 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 dá uma avaliação positiva (curtida) ao vídeo da palestra de abertura da conferência Google I/O de 2014:

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

Extrair a classificaçã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. Na solicitação, defina o valor do parâmetro id como uma lista separada por vírgulas de IDs de vídeos do YouTube dos recursos para os quais você está recuperando dados de classificação. Essa solicitação precisa ser autorizada usando o OAuth 2.0.

A solicitação de exemplo abaixo recupera a classificação do usuário atual do vídeo da palestra de abertura na conferência Google I/O de 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 da API. O valor do parâmetro indica se você quer recuperar vídeos com ou sem marcação "Gostei".

A solicitação de exemplo abaixo recupera uma lista de vídeos que o usuário atual avaliou com 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 acessar uma lista dos vídeos que o usuário gostou (mas não dos que ele deu deslike) seguindo o fluxo para recuperar os vídeos favoritos de um canal. Na etapa 1 desse processo, em vez de extrair o ID da playlist de vídeos favoritos do canal, extraia o ID da playlist de vídeos marcados com "Gostei". A propriedade contentDetails.relatedPlaylists.likes contém o valor.

Assim, a API permite que você extraia uma lista de vídeos que o usuário curtiu usando o método videos.list ou playlistItems.list. Como um recurso video retorna informações diferentes de um recurso playlistItem, você pode escolher o método mais adequado às suas necessidades.