Implementación: Calificaciones

En los siguientes ejemplos se muestra cómo utilizar la API de datos de YouTube (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 sobre un video. Esta solicitud debe autorizarse 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á calificando (o que 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 existía anteriormente para el usuario.

La solicitud de ejemplo que aparece a continuación le da una calificación positiva (me gusta) al video del discurso de apertura de la conferencia 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 del usuario actual de un video

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

La solicitud de ejemplo que aparece a continuación recupera la calificación del usuario actual del video del discurso de apertura de la conferencia de Google I/O 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

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 los videos que te gustan o no.

La solicitud de ejemplo 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 con 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 le gustaron al usuario (pero no los videos que marcó como no me gusta). Para ello, sigue el proceso para recuperar los videos favoritos de un canal. 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 del canal que te gustaron. 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 usando los métodos videos.list o playlistItems.list. Como en un recurso video se muestra información diferente que en un recurso playlistItem, puedes elegir el método que mejor se adapte a tus necesidades.