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 |
string YouTube 用来唯一标识群组的 ID。 |
snippet |
object snippet 对象包含有关群组的基本信息,包括其创建日期和名称。 |
snippet.publishedAt |
datetime 群组的创建日期和时间。该值采用 ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ ) 格式指定。 |
snippet.title |
string 群组名称。该值不得为空。 |
contentDetails |
object contentDetails 对象包含有关组的其他信息,例如它包含的项的数量和类型。 |
contentDetails.itemCount |
unsigned long 组中项的数量。 |
contentDetails.itemType |
string 组包含的资源类型。 此属性的有效值包括:
|