此页面由 Cloud Translation API 翻译。

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 请求参数匹配的组项集合。

请求

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 请求和响应。