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ãolike
,dislike
enone
. 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
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.