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