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#channelyoutube#playlistyoutube#videoyoutubePartner#asset
|
resource.id |
string
המזהה של הערוץ, הסרטון, הפלייליסט או הנכס שמשמש את YouTube לזיהוי ייחודי של הפריט שנוסף לקבוצה. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-21 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-21 (שעון UTC)."],[[["\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. |"]]
