Videos: getRating

检索授权用户对指定视频列表的评分。

对配额的影响：调用此方法的配额费用为 1 个单位。

常见使用场景

请求

HTTP 请求

GET https://www.googleapis.com/youtube/v3/videos/getRating

授权

此请求需要获得以下至少一个范围的授权（详细了解身份验证和授权）。

范围
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

参数

下表列出了此查询支持的参数。列出的所有参数都是查询参数。

参数
必需参数
id string
id 参数用于以逗号分隔列表的形式指定您要检索其评分数据的资源对应的 YouTube 视频 ID。在 video 资源中，id 属性用于指定视频的 ID。
可选参数
onBehalfOfContentOwner string
此参数只能在正确授权的请求中使用。注意：此参数仅适用于 YouTube 内容合作伙伴。

onBehalfOfContentOwner 参数用于指明该请求的授权凭据会标识代表参数值中指定的内容所有者执行操作的 YouTube 内容管理系统用户。此参数适用于拥有和管理众多不同 YouTube 频道的 YouTube 内容合作伙伴。它可让内容所有者在一次身份验证后获得访问其所有视频和频道数据的权限，而无需为每个频道提供身份验证凭据。用户进行身份验证时所用的 CMS 账号必须与指定的 YouTube 内容所有者相关联。

请求正文

调用此方法时，请勿提供请求正文。

响应

如果成功，此方法将返回采用以下结构的响应正文：

{
  "kind": "youtube#videoGetRatingResponse",
  "etag": etag,
  "items": [
    {
      "videoId": string,
      "rating": string
    }
  ]
}

属性

下表定义了此资源中显示的属性：

属性
kind string
标识 API 资源的类型。其值为 youtube#videoGetRatingResponse。
etag etag
此资源的 Etag。
items[] list
与请求条件匹配的评分列表。
items[].videoId string
YouTube 用来对视频进行唯一标识的 ID。
items[].rating string
授权用户对视频给出的评分。

此属性的有效值包括：
  • dislike
  • like
  • none
  • unspecified

错误

API 未定义此 API 方法特有的任何错误消息。不过，此方法可能仍会返回错误消息文档中列出的常规 API 错误。

试试看！

使用 APIs Explorer 调用此 API 并查看 API 请求和响应。