Groups

يمثّل مورد group مجموعة YouTube Analytics، وهي عبارة عن مجموعة مخصّصة تضمّ ما يصل إلى 500 قناة أو فيديو أو قائمة تشغيل أو مادة عرض.

يجب أن تمثل جميع العناصر في مجموعة نوع المورد نفسه. على سبيل المثال، لا يمكنك إنشاء مجموعة تحتوي على 100 فيديو و100 قائمة تشغيل.

لا يمكن أن تحتوي مجموعة "إحصاءات Google" إلا على الموارد التي حمّلتها أو طالبت بملكيتها أو المرتبطة بقناة تشرف عليها. نتيجةً لذلك، يمكن لمالكي القنوات إنشاء مجموعات من مقاطع الفيديو وقوائم التشغيل. يمكن لمالكي المحتوى إنشاء مجموعات من مقاطع الفيديو أو قوائم التشغيل أو القنوات أو مواد العرض.

الطُرق

تتوافق واجهة برمجة التطبيقات مع الطرق التالية لموردَين (groups):

list
عرض قائمة بالمجموعات التي تطابق معلمات طلب واجهة برمجة التطبيقات. مثلاً، يمكنك استرداد جميع المجموعات التي يملكها المستخدم الذي تمت المصادقة عليه، أو يمكنك استرداد مجموعة واحدة أو أكثر من خلال أرقام التعريف الفريدة. التجربة الآن
إدراج
ينشئ مجموعة YouTube Analytics. بعد إنشاء مجموعة، استخدِم طريقة 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
نوع الموارد التي تحتوي عليها المجموعة.

القيم الصالحة لهذا الموقع هي:
  • youtube#channel
  • youtube#playlist
  • youtube#video
  • youtubePartner#asset