GroupItems
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
เมธอด
API รองรับวิธีการต่อไปนี้สําหรับทรัพยากร groupItems
- list
- แสดงผลคอลเล็กชันรายการกลุ่มที่ตรงกับพารามิเตอร์คําขอ API
ลองใช้เลย
- แทรก
- สร้างรายการกลุ่ม
ลองใช้เลย
- ลบ
- นำรายการออกจากกลุ่ม
ลองใช้เลย
การนําเสนอทรัพยากร
โครงสร้าง JSON ด้านล่างแสดงรูปแบบของทรัพยากร groupItems
{
"kind": "youtube#groupItem",
"etag": etag,
"id": string,
"groupId": string,
"resource": {
"kind": string,
"id": string
}
}
พร็อพเพอร์ตี้
ตารางต่อไปนี้จะกำหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้
| พร็อพเพอร์ตี้ |
kind |
string
ระบุประเภทของทรัพยากร API ค่าจะเป็น youtube#groupItem |
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 ใช้เพื่อระบุรายการที่เพิ่มลงในกลุ่มโดยเฉพาะ |
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 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. |"]]
