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
شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد channel ، video ، playlist یا منبع asset موجود در گروه استفاده می‌کند. توجه داشته باشید که این شناسه به طور خاص به گنجاندن آن منبع در یک گروه خاص اشاره دارد و با شناسه کانال، شناسه ویدیو، شناسه فهرست پخش یا شناسه دارایی که به طور منحصربه‌فرد خود منبع را شناسایی می‌کند، متفاوت است. مقدار ویژگی resource.id کانال، ویدیو، فهرست پخش یا شناسه دارایی منحصربه‌فرد را مشخص می‌کند. |
groupId | string
شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد گروه حاوی مورد استفاده می‌کند. |
resource | object
شی resource حاوی اطلاعاتی است که آیتم اضافه شده به گروه را مشخص می کند. |
resource. kind | string
نوع منبع اضافه شده به گروه را مشخص می کند.
مقادیر معتبر برای این ویژگی عبارتند از:-
youtube#channel -
youtube#playlist -
youtube#video -
youtubePartner#asset
|
resource. id | string
کانال، ویدیو، فهرست پخش یا شناسه دارایی که YouTube برای شناسایی منحصربه‌فرد موردی که به گروه اضافه می‌شود، استفاده می‌کند. |
،
نمایندگی منابع
ساختار 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
شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد channel ، video ، playlist یا منبع asset موجود در گروه استفاده می‌کند. توجه داشته باشید که این شناسه به طور خاص به گنجاندن آن منبع در یک گروه خاص اشاره دارد و با شناسه کانال، شناسه ویدیو، شناسه فهرست پخش یا شناسه دارایی که به طور منحصربه‌فرد خود منبع را شناسایی می‌کند، متفاوت است. مقدار ویژگی resource.id کانال، ویدیو، فهرست پخش یا شناسه دارایی منحصربه‌فرد را مشخص می‌کند. |
groupId | string
شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد گروه حاوی مورد استفاده می‌کند. |
resource | object
شی resource حاوی اطلاعاتی است که آیتم اضافه شده به گروه را مشخص می کند. |
resource. kind | string
نوع منبع اضافه شده به گروه را مشخص می کند.
مقادیر معتبر برای این ویژگی عبارتند از:-
youtube#channel -
youtube#playlist -
youtube#video -
youtubePartner#asset
|
resource. id | string
کانال، ویدیو، فهرست پخش یا شناسه دارایی که YouTube برای شناسایی منحصربه‌فرد موردی که به گروه اضافه می‌شود، استفاده می‌کند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-21 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 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. |"]]
