الطُرق
تتيح واجهة برمجة التطبيقات الطرق التالية لموارد groupItems
:
- list
- تعرض مجموعة من عناصر المجموعة التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات. التجربة الآن
- إدراج
- تُنشئ عنصر مجموعة. التجربة الآن
- حذف
- تزيل عنصرًا من مجموعة. التجربة الآن
تمثيل الموارد
توضِّح بنية JSON أدناه تنسيق مورد groupItems
:
{ "kind": "youtube#groupItem", "etag": etag, "id": string, "groupId": string, "resource": { "kind": string, "id": string } }
أماكن إقامة
يحدِّد الجدول التالي السمات التي تظهر في هذا المرجع:
أماكن إقامة | |
---|---|
kind |
string لتحديد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#groupItem . |
etag |
etag رقم تعريف Etag لهذا المورد. |
id |
string المعرّف الذي تستخدمه منصة YouTube لتحديد المورد channel أو video أو playlist أو asset المضمّن في المجموعة يُرجى العِلم أنّ هذا المعرّف يشير على وجه التحديد إلى تضمين هذا المورد في مجموعة معيّنة، ويختلف عن معرّف القناة أو معرّف الفيديو أو معرّف قائمة التشغيل أو معرّف مادة العرض الذي يعرّف المورد نفسه بشكل فريد. تحدّد قيمة السمة resource.id المعرّف الفريد للقناة أو الفيديو أو قائمة التشغيل أو مادة العرض. |
groupId |
string المعرّف الذي تستخدمه YouTube لتحديد المجموعة التي تحتوي على السلعة بشكل فريد. |
resource |
object يحتوي العنصر resource على معلومات تحدّد العنصر الذي تتم إضافته إلى المجموعة. |
resource.kind |
string يحدِّد نوع المورد الذي تتم إضافته إلى المجموعة. القيم الصالحة لهذا السمة هي:
|
resource.id |
string معرّف القناة أو الفيديو أو قائمة التشغيل أو مادة العرض الذي تستخدمه YouTube لتحديد العنصر الذي تتم إضافته إلى المجموعة بشكل فريد. |