Groups

يشير مورد 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
  }
}

أماكن إقامة

يحدِّد الجدول التالي السمات التي تظهر في هذا المرجع: