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 sontlike
,dislike
etnone
. 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
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.