Groups

group 资源表示 YouTube 数据分析组，这是一个包含多达 500 个频道、视频、播放列表或资产的自定义集合。

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

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

方法

该 API 支持 groups 资源的以下方法：

list

返回与 API 请求参数匹配的组列表。例如，您可以检索已通过身份验证的用户拥有的所有群组，也可以按唯一 ID 检索一个或多个群组。立即试用。

插入

创建 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 组包含的资源类型。 此属性的有效值包括： youtube#channel youtube#playlist youtube#video youtubePartner#asset