GroupItems

الطُرق

تتوافق واجهة برمجة التطبيقات مع الطرق التالية لموردَين (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
تحدد نوع المورد الذي تتم إضافته إلى المجموعة.

القيم الصالحة لهذا الموقع هي:
  • youtube#channel
  • youtube#playlist
  • youtube#video
  • youtubePartner#asset
resource.id string
القناة أو الفيديو أو قائمة التشغيل أو معرّف مادة العرض الذي يستخدمه YouTube لتحديد العنصر الذي تتم إضافته إلى المجموعة بشكل فريد