GroupItems: list

重要提示:对此方法的 API 请求需要访问以下任一权限:
  • https://www.googleapis.com/auth/youtube 范围
  • https://www.googleapis.com/auth/youtube.readonly 范围

    https://www.googleapis.com/auth/yt-analytics.readonly 范围

第一个选项使用范围,碰巧是读写范围,而第二个选项使用两个只读范围。

返回与 API 请求参数匹配的组项集合。

请求

HTTP 请求

GET https://youtubeanalytics.googleapis.com/v2/groupItems

授权

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

权限范围
https://www.googleapis.com/auth/yt-analytics.readonly 查看有关您的 YouTube 内容的 YouTube 数据分析报告。通过此范围,您可以访问用户活动指标,例如观看次数和评分计数。
https://www.googleapis.com/auth/yt-analytics-monetary.readonly 查看 YouTube 分析工具为您的 YouTube 内容出具的财务报告。通过此范围,您可以访问用户活动指标,以及估算收入和广告效果指标。
https://www.googleapis.com/auth/youtube 管理您的 YouTube 帐号。在 YouTube Analytics API 中,频道所有者使用此范围管理 YouTube 数据分析组和组项。
https://www.googleapis.com/auth/youtubepartner 在 YouTube 上查看和管理 YouTube 资产和相关内容。在 YouTube Analytics API 中,内容所有者使用此范围管理 YouTube 数据分析组和组项。

参数

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

参数
必需参数
groupId string
id 参数指定要检索其群组项的群组的唯一 ID。
可选参数
onBehalfOfContentOwner string
此参数只能在正确的授权请求中使用。注意:此参数专供拥有和管理许多不同 YouTube 频道的 YouTube 内容合作伙伴使用。

onBehalfOfContentOwner 参数表示请求的授权凭据用于标识代表参数值中指定的内容所有者执行操作的 YouTube 用户。内容所有者只需进行一次身份验证,即可访问自己所有的视频和频道数据,而无需为每个频道提供身份验证凭据。用户通过身份验证时使用的帐号必须与指定的 YouTube 内容所有者相关联。

请求正文

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

响应

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

{
  "kind": "youtube#groupItemListResponse",
  "etag": etag,
  "items": [
    groupItem Resource
  ]
}

属性

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

属性
kind string
标识 API 资源类型。值为 youtube#groupItemListResponse
etag etag
此资源的 Etag。
items[] list
群组包含的内容的列表。列表中的每一项表示 groupItem 资源。

错误

该 API 不会定义此 API 方法所独有的任何错误消息。不过,此方法仍会返回错误消息文档中列出的常规 API 错误。

试试看!

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