Actualizaremos la API de datos para que coincida con la forma en que YouTube cuenta las vistas de Shorts.
Más información
Implementación: Calificaciones
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En los siguientes ejemplos, se muestra cómo usar la API de YouTube Data (v3) para realizar funciones relacionadas con las calificaciones de los videos.
Calificar un video
Llama al método videos.rate para enviar la calificación de un usuario para un video. Esta solicitud se debe autorizar con OAuth 2.0.
Establece los siguientes dos parámetros en tu solicitud:
- El parámetro
id especifica el ID de video de YouTube del video que se está clasificando (o al que se le quitará la clasificación).
- El parámetro
rating especifica la calificación que el usuario que autoriza la solicitud desea registrar. Los valores de parámetros válidos son like, dislike y none. Los dos primeros valores establecen una calificación, y el tercero quita cualquier calificación que haya existido anteriormente para el usuario.
En la siguiente solicitud de ejemplo, se otorga una calificación positiva (me gusta) al video del discurso de apertura de la conferencia de Google I/O de 2014:
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate?
id=wtLJPvx7-ys
&rating=like
Recupera la calificación que el usuario actual le asignó a un video
El método videos.getRating te permite recuperar la clasificación de uno o más videos del usuario autenticado actualmente. En tu solicitud, establece el valor del parámetro id en una lista separada por comas de los IDs de video de YouTube de los recursos para los que recuperas los datos de clasificación. Ten en cuenta que esta solicitud debe estar autorizada con OAuth 2.0.
En la siguiente solicitud de ejemplo, se recupera la calificación del usuario actual del video del discurso de apertura de la conferencia Google I/O de 2014. (Si ejecutaste el ejemplo anterior en el Explorador de APIs, la respuesta de la API debería indicar que la calificación es like.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating?
id=wtLJPvx7-ys
Cómo recuperar los videos calificados por el usuario actual
El parámetro myRating del método videos.list te permite recuperar una lista de videos calificados por el usuario que autoriza la solicitud a la API. El valor del parámetro indica si deseas recuperar videos que recibieron "Me gusta" o "No me gusta".
En la siguiente solicitud de ejemplo, se recupera una lista de videos a los que el usuario actual les asignó una calificación de like. La solicitud se debe autorizar con OAuth 2.0.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
part=snippet
&myRating=like
Nota: También puedes seguir el flujo para
recuperar los videos favoritos de un canal y obtener una lista de los videos que le gustaron al usuario (pero no los que no le gustaron). En el paso 1 de ese proceso, en lugar de recuperar el ID de la playlist de los videos favoritos del canal, recupera el ID de la playlist de los videos que le gustaron al canal. La propiedad
contentDetails.relatedPlaylists.likes contiene el valor.
Por lo tanto, la API te permite recuperar una lista de videos que le gustaron al usuario con el método
videos.list o el método
playlistItems.list. Dado que se muestra información diferente en un recurso
video que en un recurso
playlistItem, puedes elegir el método que mejor se adapte a tus necesidades.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-11-23 (UTC)
[null,null,["Última actualización: 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."]]
