以下示例展示了如何使用 YouTube Data API (v3) 来执行与视频评分相关的功能。
对视频评分
调用 videos.rate
方法以提交用户对视频的评分。此请求必须使用 OAuth 2.0 授权。
在请求中设置以下两个参数:
id
参数用于指定要评分(或将其移除)的 YouTube 视频 ID。rating
参数指定授权请求的用户想要记录的分级。有效的参数值包括like
、dislike
和none
。前两个值设置评分,第三个值移除用户之前存在的所有评分。
以下示例请求为 2014 年 Google I/O 大会上的主旨演讲视频给出了正面(顶)评分:
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate? id=wtLJPvx7-ys &rating=like
检索当前用户对视频的评分
借助 videos.getRating
方法,您可以检索当前经过身份验证的用户对一个或多个视频的评分。在您的请求中,针对您要检索评分数据的资源,将 id
参数的值设置为以英文逗号分隔的 YouTube 视频 ID 列表。请注意,此请求必须使用 OAuth 2.0 获得授权。
以下示例请求会检索当前用户在 2014 年 Google I/O 大会上的主旨演讲视频的评分。(如果您在 API Explorer 中执行了上一个示例,API 响应应指明评分为 like
。
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating? id=wtLJPvx7-ys
检索当前用户评分的视频
借助 videos.list
方法的 myRating
参数,您可以检索由授权 API 请求的用户评分的视频列表。此参数值用于指明您是想检索顶过的视频还是踩过的视频。
以下示例请求会检索当前用户给出的 like
评分的视频列表。必须使用 OAuth 2.0 对请求进行授权。
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list? part=snippet &myRating=like
注意:您还可以按照检索频道收藏的视频的流程,检索用户顶过的视频(但不是被踩的视频)的列表。在该流程的第 1 步中,检索频道顶过视频的播放列表 ID,而不是检索其收藏视频的播放列表 ID。
因此,该 API 允许您使用
contentDetails.relatedPlaylists.likes
属性包含值。因此,该 API 允许您使用
videos.list
方法或 playlistItems.list
方法检索用户喜欢的视频列表。由于 video
资源中返回的信息与 playlistItem
资源中返回的信息不同,因此您可以选择最符合您需求的方法。