Groups
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يشير مورد group إلى مجموعة "إحصاءات YouTube"، وهي مجموعة مخصّصة تضمّ ما يصل إلى 500 قناة أو فيديو أو قائمة تشغيل أو مادة عرض.
يجب أن تمثّل جميع العناصر في المجموعة النوع نفسه من الموارد. على سبيل المثال، لا يمكنك إنشاء مجموعة تضم 100 فيديو و100 قائمة تشغيل.
لا يمكن أن تحتوي مجموعة "إحصاءات YouTube" إلا على المراجع التي حمّلتها أو طالبت بملكيتها أو التي تم ربطها بقناة تديرها. نتيجةً لذلك، يمكن لمالكي القنوات إنشاء مجموعات من الفيديوهات وقوائم التشغيل. يمكن لمالكي المحتوى إنشاء مجموعات من الفيديوهات أو قوائم التشغيل أو القنوات أو مواد العرض.
الطُرق
تتيح واجهة برمجة التطبيقات الطرق التالية لموارد groups:
- list
- يعرض قائمة بالمجموعات التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات. على سبيل المثال، يمكنك استرداد جميع المجموعات التي يملكها المستخدم الذي تمّت مصادقة هويته، أو يمكنك استرداد مجموعة واحدة أو أكثر من خلال أرقام تعريفها الفريدة.
التجربة الآن
- إدراج
- إنشاء مجموعة في "إحصاءات YouTube" بعد إنشاء مجموعة، استخدِم الطريقة
groupItems.insert لإضافة عناصر إلى المجموعة.
جرِّب ذلك الآن.
- تعديل
- تعديل البيانات الوصفية لمجموعة في الوقت الحالي، السمة الوحيدة التي يمكن تعديلها هي عنوان المجموعة. (استخدِم
groupItems.insert وgroupItems.delete لإضافة عناصر المجموعة وإزالتها).
جرِّب ذلك الآن.
- حذف
- لحذف مجموعة
التجربة الآن
أماكن إقامة
يحدِّد الجدول التالي السمات التي تظهر في هذا المرجع:
| أماكن إقامة |
kind |
string
لتحديد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#group. |
etag |
etag
رقم تعريف Etag لهذا المورد. |
id |
string
المعرّف الذي تستخدمه YouTube لتحديد المجموعة بشكل فريد |
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#channelyoutube#playlistyoutube#videoyoutubePartner#asset
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eA YouTube Analytics group is a custom collection of up to 500 channels, videos, playlists, or assets, all of the same resource type.\u003c/p\u003e\n"],["\u003cp\u003eYou can create, retrieve, update, and delete groups using the YouTube Analytics API methods.\u003c/p\u003e\n"],["\u003cp\u003eGroups can only contain resources that you own, have claimed, or are linked to a channel you administer.\u003c/p\u003e\n"],["\u003cp\u003eThe group resource representation includes information such as the group's ID, title, creation date, item count, and item type.\u003c/p\u003e\n"],["\u003cp\u003eUse the \u003ccode\u003egroupItems\u003c/code\u003e methods to manage the individual items within a group.\u003c/p\u003e\n"]]],["YouTube Analytics groups are custom collections of up to 500 channels, videos, playlists, or assets of the same type. The API allows users to list, insert, update, and delete groups. Creating a group requires specifying the group's name. Updating a group only allows changing its title, while adding or removing items is handled through a separate method. Each group has an ID, creation date, and details about the number and type of contained items.\n"],null,["# Groups\n\nA **group** resource represents a YouTube Analytics group, which is a custom collection of up to 500 channels, videos, playlists, or assets. \n\nAll of the items in a group must represent the same type of resource. For example, you cannot create a group that contains 100 videos and 100 playlists. \n\nAn Analytics group can only contain resources that you have uploaded or claimed or that are linked to a channel that you administer. As a result, channel owners can create groups of videos and playlists. Content owners can create groups of videos, playlists, channels, or assets.\n\nMethods\n-------\n\nThe API supports the following methods for `groups` resources:\n\n[list](/youtube/analytics/reference/groups/list)\n: Returns a list of groups that match the API request parameters. For example, you can retrieve all groups that the authenticated user owns, or you can retrieve one or more groups by their unique IDs.\n [Try it now](/youtube/analytics/reference/groups/list#try-it).\n\n[insert](/youtube/analytics/reference/groups/insert)\n: Creates a YouTube Analytics group. After creating a group, use the [groupItems.insert](/youtube/analytics/reference/groupItems/insert) method to add items to the group.\n [Try it now](/youtube/analytics/reference/groups/insert#try-it).\n\n[update](/youtube/analytics/reference/groups/update)\n: Modifies the metadata for a group. Currently, the only property that can be updated is the group's title. (Use the [groupItems.insert](/youtube/analytics/reference/groupItems/insert) and [groupItems.delete](/youtube/analytics/reference/groupItems/delete) to add and remove group items.)\n [Try it now](/youtube/analytics/reference/groups/update#try-it).\n\n[delete](/youtube/analytics/reference/groups/delete)\n: Deletes a group.\n [Try it now](/youtube/analytics/reference/groups/delete#try-it).\n\nResource representation\n-----------------------\n\nThe JSON structure below shows the format of a `groups` resource: \n\n```text\n{\n \"kind\": \"youtube#group\",\n \"etag\": etag,\n \"id\": string,\n \"snippet\": {\n \"publishedAt\": datetime,\n \"title\": string\n },\n \"contentDetails\": {\n \"itemCount\": unsigned long,\n \"itemType\": 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#group`. |\n| `etag` | `etag` The Etag of this resource. |\n| `id` | `string` The ID that YouTube uses to uniquely identify the group. |\n| `snippet` | `object` The `snippet` object contains basic information about the group, including its creation date and name. |\n| snippet.`publishedAt` | `datetime` The date and time that the group was created. The value is specified in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) (`YYYY-MM-DDThh:mm:ss.sZ`) format. |\n| snippet.`title` | `string` The group name. The value must be a non-empty string. |\n| `contentDetails` | `object` The `contentDetails` object contains additional information about the group, such as the number and type of items that it contains. |\n| contentDetails.`itemCount` | `unsigned long` The number of items in the group. |\n| contentDetails.`itemType` | `string` The type of resources that the group contains. Valid values for this property are: - `youtube#channel` - `youtube#playlist` - `youtube#video` - `youtubePartner#asset` |"]]
