group 资源代表 YouTube 数据分析群组,这是一个由最多 500 个频道、视频、播放列表或资产组成的自定义集合。
 组中的所有项都必须代表同一类型的资源。例如,您无法创建包含 100 个视频和 100 个播放列表的群组。
Google Analytics 群组只能包含您已上传或声明的资源,或者已与您管理的渠道相关联的资源。因此,频道所有者可以创建视频和播放列表群组。内容所有者可以创建视频组、播放列表、频道或资产组。
方法
该 API 支持对 groups 资源使用以下方法:
- list
- 返回与 API 请求参数匹配的组列表。例如,您可以检索经过身份验证的用户拥有的所有群组,也可以按唯一 ID 检索一个或多个群组。立即试用。
- insert
- 创建 YouTube 数据分析组。创建组后,使用 groupItems.insert方法向组中添加项。 立即试用。
- update
- 修改组的元数据。目前,唯一可更新的属性是群组的标题。(使用 groupItems.insert和groupItems.delete添加和移除组项。) 立即试用。
- delete
- 删除群组。立即试用。
资源表示法
以下 JSON 结构显示了 groups 资源的格式:
{
  "kind": "youtube#group",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "title": string
  },
  "contentDetails": {
    "itemCount": unsigned long,
    "itemType": string
  }
}属性
下表定义了此资源中显示的属性:
| 属性 | |
|---|---|
| kind | string用于标识 API 资源的类型。该值将为 youtube#group。 | 
| etag | etag此资源的 Etag。 | 
| id | stringYouTube 用来唯一标识群组的 ID。 | 
| snippet | objectsnippet对象包含有关群组的基本信息,包括其创建日期和名称。 | 
| snippet.publishedAt | datetime群组的创建日期和时间。该值采用 ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ) 格式指定。 | 
| snippet.title | string群组名称。该值不得为空。 | 
| contentDetails | objectcontentDetails对象包含有关组的其他信息,例如它包含的项的数量和类型。 | 
| contentDetails.itemCount | unsigned long组中项的数量。 | 
| contentDetails.itemType | string组包含的资源类型。 此属性的有效值包括: 
 |