Implementación: Calificaciones

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.