Groups

group 资源代表 YouTube 数据分析群组,这是一个由最多 500 个频道、视频、播放列表或资产组成的自定义集合。

组中的所有项都必须代表同一类型的资源。例如,您无法创建包含 100 个视频和 100 个播放列表的群组。

Google Analytics 群组只能包含您已上传或声明的资源,或者已与您管理的渠道相关联的资源。因此,频道所有者可以创建视频和播放列表群组。内容所有者可以创建视频组、播放列表、频道或资产组。

方法

该 API 支持对 groups 资源使用以下方法:

list
返回与 API 请求参数匹配的组列表。例如,您可以检索经过身份验证的用户拥有的所有群组,也可以按唯一 ID 检索一个或多个群组。立即试用
insert
创建 YouTube 数据分析组。创建组后,使用 groupItems.insert 方法向组中添加项。 立即试用
update
修改组的元数据。目前,唯一可更新的属性是群组的标题。(使用 groupItems.insertgroupItems.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
组包含的资源类型。

此属性的有效值包括:
  • youtube#channel
  • youtube#playlist
  • youtube#video
  • youtubePartner#asset