实现:评分

以下示例展示了如何使用 YouTube Data API (v3) 执行与视频评分相关的函数。

对视频评分

调用 videos.rate 方法以提交用户对视频的评分。此请求必须使用 OAuth 2.0 进行授权。

在您的请求中设置以下两个参数:

  • id 参数用于指定正在分级(或已移除分级)的视频的 YouTube 视频 ID。
  • rating 参数用于指定向请求授权的用户希望记录的评分。有效的参数值包括 likedislikenone。前两个值用于设置评分,而第三个值用于移除之前为用户存在的任何评分。

以下示例请求对 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。contentDetails.relatedPlaylists.likes 属性包含相应的值。

因此,该 API 允许您使用 videos.list 方法或 playlistItems.list 方法来检索用户喜欢的视频列表。由于 video 资源与 playlistItem 资源中返回的信息不同,因此您可以选择最适合自己需求的方法。