Mise en œuvre: notes

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

Donner un avis sur une vidéo

Appelez la méthode videos.rate pour envoyer la note d'un utilisateur à 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 évaluée (ou dont la classification a été supprimée).
  • Le paramètre rating spécifie la note que l'utilisateur autorisant la requête souhaite enregistrer. Les valeurs valides pour ce paramètre sont like, dislike et none. Les deux premières valeurs définissent une note, et la troisième supprime toute note précédemment associée à l'utilisateur.

L'exemple de demande ci-dessous attribue une note positive à la vidéo du discours d'ouverture de la conférence Google I/O de 2014:

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

Récupérer l'avis d'un utilisateur sur une vidéo

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

L'exemple de requête ci-dessous récupère la note de l'utilisateur actuel concernant la vidéo du discours d'ouverture 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 notées par l'utilisateur actuel

Le paramètre myRating de la méthode videos.list vous permet de récupérer la liste des vidéos évaluées par l'utilisateur qui a autorisé 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 auxquelles l'utilisateur actuel a attribué la 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 "J'aime" d'un utilisateur (mais pas celles que vous avez aimées) en suivant la procédure de récupération des vidéos préférées d'une chaîne. À l'étape 1, au lieu de récupérer l'ID de la playlist des vidéos préférées de la chaîne, récupérez l'ID de la playlist des vidéos que vous avez aimées. La propriété contentDetails.relatedPlaylists.likes contient la valeur.

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