Videos: batchGetStats

检索与 API 请求参数匹配的视频统计信息列表。

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

请求

HTTP 请求

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

授权

若要针对非公开视频使用此方法，必须进行身份验证，但对于公开视频则无需进行身份验证。如果提供了授权，则必须使用以下至少一个范围对请求进行授权（详细了解身份验证和授权）。

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

参数

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

参数
必需参数
id string
id 参数用于指定要检索的资源的 YouTube 视频 ID 列表（以英文逗号分隔）。在 videoStat 资源中，id 属性用于指定视频的 ID。
part string
part 参数用于指定一个或多个 videoStat 资源属性的逗号分隔列表，API 响应将包含这些属性。

以下列表包含您可以包含在参数值中的 part 名称：
  • contentDetails
  • id
  • snippet
  • statistics
可选参数
onBehalfOfContentOwner string
此参数只能在经过适当授权的请求中使用。注意： 此参数仅供 YouTube 内容合作伙伴使用。

onBehalfOfContentOwner 参数表示请求的授权凭据标识的是一个 YouTube 内容管理系统 (CMS) 用户，该用户代表参数值中指定的内容所有者行事。此参数适用于拥有和管理许多不同 YouTube 频道的 YouTube 内容合作伙伴。它允许内容所有者进行一次身份验证，即可访问其所有视频和频道数据，而无需为每个频道提供身份验证凭据。用户进行身份验证时使用的 CMS 账号必须与指定的 YouTube 内容所有者相关联。

请求正文

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

响应

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

{
  "kind": "youtube#batchGetStatsResponse",
  "etag": etag,
  "items": [
    {
      "kind": "youtube#videoStats",
      "etag": etag,
      "id": string,
      "snippet": {
        "publishTime": datetime
      },
      "statistics": {
        "viewCount": unsigned long,
        "likeCount": unsigned long,
        "commentCount": unsigned long
      },
      "contentDetails": {
        "duration": string,
        "durationMillis": unsigned long
      }
    }
  ],
  "summary": {
    "requestedVideoCount": unsigned long,
    "succeededVideoCount": unsigned long,
    "failedVideoCount": unsigned long,
    "failedVideoIds": [
      string
    ]
  }
}

属性

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

属性
kind string
标识 API 资源的类型。该值将为 youtube#batchGetStatsResponse。
etag etag
此资源的 ETag。
items[] list
与请求条件匹配的视频统计信息列表。
items[].id string
YouTube 用于唯一标识视频的 ID。
items[].snippet.publishTime datetime
视频的上传日期和时间。
items[].statistics.viewCount unsigned long
视频的观看次数。
items[].statistics.likeCount unsigned long
表示喜欢该视频的用户数。
items[].statistics.commentCount unsigned long
视频的评论数。
items[].contentDetails.duration string
视频的时长。
items[].contentDetails.durationMillis unsigned long
视频的时长（以毫秒为单位）。
summary object
batchGetStats 请求的摘要。
summary.requestedVideoCount unsigned long
请求的视频数量。
summary.succeededVideoCount unsigned long
成功的视频数量。
summary.failedVideoCount unsigned long
失败的视频数量。
summary.failedVideoIds[] list
失败的视频 ID。

错误

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