Implementación: Calificaciones

Los siguientes ejemplos muestran cómo utilizar la API de datos de YouTube (v3) para realizar funciones relacionadas con las calificaciones de videos.

Calificar un video

Invoca el método videos.rate para enviar la calificación de un usuario para un video. Esta solicitud debe autorizarse con OAuth 2.0.

Establece los dos parámetros siguientes en tu solicitud:

  • El parámetro id especifica la identificación de video de YouTube del video que se está calificando (o cuya calificación se está eliminando).
  • El parámetro rating especifica la calificación que el usuario que autoriza la solicitud desea registrar. Los valores de parámetro 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.

La siguiente solicitud de ejemplo otorga una calificación positiva (Me gusta) al video del discurso de apertura en la conferencia de Google I/O 2014:

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

Recuperar la calificación actual de un video por parte del usuario

El método videos.getRating te permite recuperar la calificación del usuario autenticado actualmente de uno o más videos. En tu solicitud, establece el valor del parámetro id en una lista separada por comas de ID de videos de YouTube para los recursos para los que vas a recuperar los datos de calificación. Ten en cuenta que esta solicitud se debe autorizar mediante OAuth 2.0.

La solicitud de ejemplo que aparece a continuación recupera la calificación del video actual del discurso de apertura en la conferencia de Google I/O 2014. (Si ejecutaste el ejemplo anterior en el Explorador de API, la respuesta de la API debe indicar que la calificación es like.

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

Recuperar 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 quieres recuperar videos que te gustaron o no.

La solicitud de muestra que aparece a continuación recupera una lista de videos a los que el usuario actual le dio una calificación de like. La solicitud se debe autorizar mediante OAuth 2.0.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
part=snippet
&myRating=like
Nota: También puedes recuperar una lista de los videos que te gustaron del usuario (pero no los que no te gustaron) si sigues el proceso para recuperar los videos favoritos de un canal. En el 1 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 mediante el método videos.list o 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.