يمثّل مورد group
مجموعة YouTube Analytics، وهي عبارة عن مجموعة مخصّصة تضمّ ما يصل إلى 500 قناة أو فيديو أو قائمة تشغيل أو مادة عرض.
يجب أن تمثل جميع العناصر في مجموعة نوع المورد نفسه. على سبيل المثال، لا يمكنك إنشاء مجموعة تحتوي على 100 فيديو و100 قائمة تشغيل.
لا يمكن أن تحتوي مجموعة "إحصاءات Google" إلا على الموارد التي حمّلتها أو طالبت بملكيتها أو المرتبطة بقناة تشرف عليها. نتيجةً لذلك، يمكن لمالكي القنوات إنشاء مجموعات من مقاطع الفيديو وقوائم التشغيل. يمكن لمالكي المحتوى إنشاء مجموعات من مقاطع الفيديو أو قوائم التشغيل أو القنوات أو مواد العرض.
الطُرق
تتوافق واجهة برمجة التطبيقات مع الطرق التالية لموردَين (groups
):
- list
- عرض قائمة بالمجموعات التي تطابق معلمات طلب واجهة برمجة التطبيقات. مثلاً، يمكنك استرداد جميع المجموعات التي يملكها المستخدم الذي تمت المصادقة عليه، أو يمكنك استرداد مجموعة واحدة أو أكثر من خلال أرقام التعريف الفريدة. التجربة الآن
- إدراج
- ينشئ مجموعة YouTube Analytics. بعد إنشاء مجموعة، استخدِم طريقة
groupItems.insert
لإضافة عناصر إلى المجموعة. التجربة الآن - تحديث
- تعديل البيانات الوصفية لمجموعة. حاليًا، الموقع الوحيد الذي يمكن تحديثه هو عنوان المجموعة. (استخدم
groupItems.insert
وgroupItems.delete
لإضافة عناصر المجموعة وإزالتها.) التجربة الآن - حذف
- حذف مجموعة. التجربة الآن
تمثيل الموارد
تعرض بنية JSON أدناه تنسيق مورد groups
:
{ "kind": "youtube#group", "etag": etag, "id": string, "snippet": { "publishedAt": datetime, "title": string }, "contentDetails": { "itemCount": unsigned long, "itemType": string } }
أماكن إقامة
يحدد الجدول التالي الخصائص التي تظهر في هذا المورد:
أماكن إقامة | |
---|---|
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 نوع الموارد التي تحتوي عليها المجموعة. القيم الصالحة لهذا الموقع هي:
|