GroupItems
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
资源表示法
以下 JSON 结构显示了 groupItems
资源的格式:
{
"kind": "youtube#groupItem",
"etag": etag,
"id": string,
"groupId": string,
"resource": {
"kind": string,
"id": string
}
}
属性
下表定义了此资源中显示的属性:
属性 |
kind |
string
标识 API 资源的类型。该值将为 youtube#groupItem 。 |
etag |
etag 此资源的 Etag。 |
id |
string
此 ID 用于由 YouTube 唯一标识群组中包含的 channel 、video 、playlist 或 asset 资源。请注意,此 ID 特指将该资源纳入特定资源组中,它不同于对资源本身进行唯一标识的频道 ID、视频 ID、播放列表 ID 或资产 ID。resource.id 属性的值用于指定唯一的频道、视频、播放列表或资产 ID。 |
groupId |
string
YouTube 用来标识包含相应项的组的唯一 ID。 |
resource |
object
resource 对象包含用于标识要添加到组的项的信息。 |
resource.kind |
string
用于标识要添加到组中的资源类型。
此属性的有效值如下:
youtube#channel
youtube#playlist
youtube#video
youtubePartner#asset
|
resource.id |
string
YouTube 用于对添加到组中的内容进行唯一标识的频道、视频、播放列表或资产 ID。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-21。
[null,null,["最后更新时间 (UTC):2025-08-21。"],[[["\u003cp\u003eThe YouTube Analytics API provides methods to manage group items, enabling you to list, insert, and delete them within groups.\u003c/p\u003e\n"],["\u003cp\u003eGroup items associate a YouTube resource like a channel, video, or playlist with a specific group for analysis.\u003c/p\u003e\n"],["\u003cp\u003eEach group item is uniquely identified by an ID and contains information about the resource it links to and the group it belongs to.\u003c/p\u003e\n"],["\u003cp\u003eThe API uses a JSON structure to represent group items, including properties like \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003eetag\u003c/code\u003e, \u003ccode\u003eid\u003c/code\u003e, \u003ccode\u003egroupId\u003c/code\u003e, and \u003ccode\u003eresource\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eresource\u003c/code\u003e property within a group item further specifies the type and unique ID of the linked YouTube resource (channel, video, playlist, or asset).\u003c/p\u003e\n"]]],["The API for `groupItems` resources supports listing, inserting, and deleting items. `groupItems` contain properties like `kind`, `etag`, `id`, and `groupId`. The `resource` object within a `groupItem` identifies the item, specifying its `kind` (channel, playlist, video, or asset) and its unique `id`. The `id` in groupItem identifies a specific resource within a group and is different than the resources' ID, while the `groupId` is the identifier for the group containing the item.\n"],null,["# GroupItems\n\n\u003cbr /\u003e\n\nMethods\n-------\n\nThe API supports the following methods for `groupItems` resources:\n\n[list](/youtube/analytics/reference/groupItems/list)\n: Returns a collection of group items that match the API request parameters.\n [Try it now](/youtube/analytics/reference/groupItems/list#try-it).\n\n[insert](/youtube/analytics/reference/groupItems/insert)\n: Creates a group item.\n [Try it now](/youtube/analytics/reference/groupItems/insert#try-it).\n\n[delete](/youtube/analytics/reference/groupItems/delete)\n: Removes an item from a group.\n [Try it now](/youtube/analytics/reference/groupItems/delete#try-it).\n\nResource representation\n-----------------------\n\nThe JSON structure below shows the format of a `groupItems` resource: \n\n```text\n{\n \"kind\": \"youtube#groupItem\",\n \"etag\": etag,\n \"id\": string,\n \"groupId\": string,\n \"resource\": {\n \"kind\": string,\n \"id\": string\n }\n}\n```\n\n### Properties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the API resource's type. The value will be `youtube#groupItem`. |\n| `etag` | `etag` The Etag of this resource. |\n| `id` | `string` The ID that YouTube uses to uniquely identify the `channel`, `video`, `playlist`, or `asset` resource that is included in the group. Note that this ID refers specifically to the inclusion of that resource in a particular group and is different than the channel ID, video ID, playlist ID, or asset ID that uniquely identifies the resource itself. The [resource.id](#resource.id) property's value specifies the unique channel, video, playlist, or asset ID. |\n| `groupId` | `string` The ID that YouTube uses to uniquely identify the group that contains the item. |\n| `resource` | `object` The `resource` object contains information that identifies the item being added to the group. |\n| resource.`kind` | `string` Identifies the type of resource being added to the group. Valid values for this property are: - `youtube#channel` - `youtube#playlist` - `youtube#video` - `youtubePartner#asset` |\n| resource.`id` | `string` The channel, video, playlist, or asset ID that YouTube uses to uniquely identify the item that is being added to the group. |"]]