يشير مورد group إلى مجموعة "إحصاءات YouTube"، وهي مجموعة مخصّصة تضمّ ما يصل إلى 500 قناة أو فيديو أو قائمة تشغيل أو مادة عرض.
يجب أن تمثّل جميع العناصر في المجموعة النوع نفسه من الموارد. على سبيل المثال، لا يمكنك إنشاء مجموعة تضم 100 فيديو و100 قائمة تشغيل.
لا يمكن أن تحتوي مجموعة "إحصاءات YouTube" إلا على المراجع التي حمّلتها أو طالبت بملكيتها أو التي تم ربطها بقناة تديرها. نتيجةً لذلك، يمكن لمالكي القنوات إنشاء مجموعات من الفيديوهات وقوائم التشغيل. يمكن لمالكي المحتوى إنشاء مجموعات من الفيديوهات أو قوائم التشغيل أو القنوات أو مواد العرض.
الطُرق
تتيح واجهة برمجة التطبيقات الطرق التالية لموارد groups:
- list
- يعرض قائمة بالمجموعات التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات. على سبيل المثال، يمكنك استرداد جميع المجموعات التي يملكها المستخدم الذي تمّت مصادقة هويته، أو يمكنك استرداد مجموعة واحدة أو أكثر من خلال أرقام تعريفها الفريدة. التجربة الآن
- إدراج
- إنشاء مجموعة في "إحصاءات YouTube" بعد إنشاء مجموعة، استخدِم الطريقة
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نوع الموارد التي تحتوي عليها المجموعة. في ما يلي القيم الصالحة لهذه السمة:
|