Mise en œuvre: classifications

Les exemples suivants montrent comment utiliser l'API YouTube Data (v3) pour effectuer des fonctions liées aux avis sur les vidéos.

Donner un avis sur une vidéo

Appelez la méthode videos.rate pour donner la note d'un utilisateur à une vidéo. Cette requête doit être autorisée à l'aide du protocole OAuth 2.0.

Définissez les deux paramètres suivants dans votre requête:

  • Le paramètre id spécifie l'ID vidéo YouTube de la vidéo évaluée (ou dont la classification est supprimée).
  • Le paramètre rating spécifie la note que l'utilisateur autorisant la requête souhaite enregistrer. Les valeurs de paramètres valides sont like, dislike et none. Les deux premières valeurs définissent une note, et la troisième supprime toute note qui existait auparavant pour l'utilisateur.

L'exemple de demande ci-dessous donne une note positive (ou "J'aime") à la vidéo du discours d'ouverture de la conférence Google I/O 2014:

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

Récupérer la note de l'utilisateur actuel sur une vidéo

La méthode videos.getRating vous permet de récupérer la note de l'utilisateur actuellement authentifié sur une ou plusieurs vidéos. Dans votre demande, définissez la valeur du paramètre id sur une liste d'ID vidéo YouTube séparés par une virgule pour les ressources pour lesquelles vous récupérez des données d'évaluation. Notez que cette requête doit être autorisée à l'aide du protocole OAuth 2.0.

L'exemple de requête ci-dessous permet de récupérer la note que l'utilisateur actuel a donnée à la vidéo du discours d'ouverture lors de la conférence Google I/O 2014. (Si vous avez exécuté l'exemple précédent dans APIs Explorer, la réponse de l'API doit indiquer que la note est like.

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

Récupérer les vidéos évaluées par l'utilisateur actuel

Le paramètre myRating de la méthode videos.list vous permet de récupérer une liste de vidéos évaluées par l'utilisateur autorisant la requête API. La valeur du paramètre indique si vous souhaitez récupérer les vidéos que vous aimez ou non.

L'exemple de requête ci-dessous permet de récupérer la liste des vidéos pour lesquelles l'utilisateur actuel a donné une note de like. La requête doit être autorisée à l'aide du protocole OAuth 2.0.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
part=snippet
&myRating=like
Remarque:Vous pouvez également récupérer la liste des vidéos que l'utilisateur a aimées (mais pas de ses vidéos "Je n'aime pas") en suivant la procédure permettant de récupérer les vidéos préférées d'une chaîne. Lors de l'étape 1 de cette procédure, au lieu de récupérer l'ID de playlist des vidéos préférées de la chaîne, récupérez l'ID de la playlist pour les vidéos "J'aime" de la chaîne. La propriété contentDetails.relatedPlaylists.likes contient la valeur.

L'API vous permet donc de récupérer une liste de vidéos que l'utilisateur a aimées à l'aide des méthodes videos.list ou playlistItems.list. Étant donné que les informations renvoyées sont différentes dans une ressource video et une ressource playlistItem, vous pouvez choisir la méthode la plus adaptée à vos besoins.