Mise en œuvre: classifications

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

Donner un avis sur une vidéo

Appelez la méthode videos.rate pour envoyer la note d'un utilisateur pour une vidéo. Cette requête doit être autorisée à l'aide d'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 qui est notée (ou dont la note est supprimée).
  • Le paramètre rating spécifie la note que l'utilisateur qui autorise la requête souhaite enregistrer. Les valeurs de paramètre valides sont like, dislike et none. Les deux premières valeurs définissent une note, et la troisième supprime toute note précédemment attribuée à l'utilisateur.

L'exemple de requête ci-dessous attribue une note positive (J'aime) à la vidéo de la conférence inaugurale 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 attribuée par l'utilisateur actuel à une vidéo

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

L'exemple de requête ci-dessous récupère la note de l'utilisateur actuel pour la vidéo de la conférence inaugurale de la conférence Google I/O 2014. (Si vous avez exécuté l'exemple précédent dans l'explorateur d'API, 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 qui autorise la requête API. La valeur du paramètre indique si vous souhaitez récupérer les vidéos "J'aime" ou "Je n'aime pas".

L'exemple de requête ci-dessous récupère la liste des vidéos auxquelles l'utilisateur actuel a attribué une note like. La requête doit être autorisée à l'aide d'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 celles qu'il n'a pas aimées) en suivant la procédure permettant de récupérer les vidéos préférées d'une chaîne. À l'étape 1 de ce processus, au lieu de récupérer l'ID de la playlist pour les 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.

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