Groups

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

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

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

方法

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

list
返回与 API 请求参数匹配的组列表。例如,您可以检索已通过身份验证的用户拥有的所有群组,也可以按唯一 ID 检索一个或多个群组。立即试用
插入
创建 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