Estamos atualizando a API Data para corresponder à forma como o YouTube conta as visualizações dos Shorts.
Saiba mais
Implementação: classificações
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-11-23 UTC.
[null,null,["Última atualização 2024-11-23 UTC."],[[["\u003cp\u003eThe YouTube Data API (v3) allows users to rate videos using the \u003ccode\u003evideos.rate\u003c/code\u003e method, with options to \u003ccode\u003elike\u003c/code\u003e, \u003ccode\u003edislike\u003c/code\u003e, or remove a rating (\u003ccode\u003enone\u003c/code\u003e), requiring OAuth 2.0 authorization.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve the currently authenticated user's rating for specific videos by using the \u003ccode\u003evideos.getRating\u003c/code\u003e method and providing a comma-separated list of video IDs, also requiring OAuth 2.0.\u003c/p\u003e\n"],["\u003cp\u003eThe API enables the retrieval of a list of videos rated by the current user, either liked or disliked, through the \u003ccode\u003evideos.list\u003c/code\u003e method and its \u003ccode\u003emyRating\u003c/code\u003e parameter, which also requires OAuth 2.0.\u003c/p\u003e\n"],["\u003cp\u003eAlternatively, users can retrieve a list of their liked videos by using the \u003ccode\u003eplaylistItems.list\u003c/code\u003e method and accessing the \u003ccode\u003econtentDetails.relatedPlaylists.likes\u003c/code\u003e property, which offers an alternative to the \u003ccode\u003evideos.list\u003c/code\u003e method.\u003c/p\u003e\n"]]],["The YouTube Data API (v3) facilitates video rating management. Using `videos.rate`, users can set or remove ratings (`like`, `dislike`, `none`) for specific videos via the `id` and `rating` parameters. `videos.getRating` retrieves a user's rating for videos, referencing video IDs. The `videos.list` method, with the `myRating` parameter, fetches videos the user has rated as \"like\", and similar functionality is available via the `playlistItems.list` method. All requests require OAuth 2.0 authorization.\n"],null,["# Implementation: Ratings\n\nThe following examples show how to use the YouTube Data API (v3) to perform functions related to video ratings.\n\nRate a video\n------------\n\nCall the [videos.rate](/youtube/v3/docs/videos/rate) method to submit a user's rating for a video. This request must be authorized using OAuth 2.0.\n\nSet the following two parameters in your request:\n\n\u003cbr /\u003e\n\n- The [id](/youtube/v3/docs/videos/rate#id) parameter specifies the YouTube video ID of the video that is being rated (or having its rating removed).\n- The [rating](/youtube/v3/docs/videos/rate#rating) parameter specifies the rating that the user authorizing the request wishes to record. Valid parameter values are `like`, `dislike`, and `none`. The first two values set a rating, and the third removes any rating that previously existed for the user.\n\n\u003cbr /\u003e\n\nThe sample request below gives a positive (like) rating to the video of the keynote speech at the 2014 Google I/O conference: \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate?\n id=wtLJPvx7-ys\n &rating=like\n```\n\nRetrieve the current user's rating of a video\n---------------------------------------------\n\nThe [videos.getRating](/youtube/v3/docs/videos/getRating) method lets you retrieve the currently authenticated user's rating of one or more videos. In your request, set the [id](/youtube/v3/docs/videos/rate#id) parameter's value to a comma-separated list of YouTube video IDs for the resources for which you are retrieving rating data. Note that this request must be authorized using OAuth 2.0.\n\nThe sample request below retrieves the current user's rating of the video of the keynote speech at the 2014 Google I/O conference. (If you executed the previous example in the APIs Explorer, the API response should indicate that the rating is `like`. \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating?\nid=wtLJPvx7-ys\n```\n\nRetrieve videos rated by the current user\n-----------------------------------------\n\nThe `videos.list` method's [myRating](/youtube/v3/docs/videos/list#myRating) parameter lets you retrieve a list of videos rated by the user authorizing the API request. The parameter value indicates whether you want to retrieve liked or disliked videos.\n\nThe sample request below retrieves a list of videos to which the current user gave a `like` rating. The request must be authorized using OAuth 2.0. \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?\npart=snippet\n&myRating=like\n``` \n**Note:** You can also retrieve a list of the user's liked videos (but not disliked videos) by following the flow for [retrieving a channel's favorite videos](#favorites). In step 1 of that process, instead of retrieving the playlist ID for the channel's favorite videos, retrieve the playlist ID for the channel's liked videos. The `contentDetails.relatedPlaylists.likes` property contains the value. \n\nThus, the API allows you to retrieve a list of videos that the user liked using either the `videos.list` method or the `playlistItems.list` method. Since different information is returned in a `video` resource than a `playlistItem` resource, you can choose the method that best suits your needs."]]
