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组包含的资源类型。 此属性的有效值包括:
|