GroupItems: list

ملاحظة مُهمّة: تتطلّب طلبات البيانات من واجهة برمجة التطبيقات لتنفيذ هذه الطريقة الوصول إلى أيّ مما يلي:
  • نطاق https://www.googleapis.com/auth/youtube
  • نطاق https://www.googleapis.com/auth/youtube.readonly
    و
    نطاق https://www.googleapis.com/auth/yt-analytics.readonly

يستخدم الخيار الأول نطاقًا واحدًا، والذي يصادف أنه نطاق للقراءة والكتابة، بينما يستخدم الخيار الثاني نطاقين للقراءة فقط.

تعرِض هذه الدالة مجموعة من عناصر المجموعة التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات.

الطلب

طلب HTTP

GET https://youtubeanalytics.googleapis.com/v2/groupItems

التفويض

يتطلب هذا الطلب تفويضًا بنطاق واحد على الأقل من النطاقات التالية (اطّلِع على مزيد من المعلومات عن المصادقة والتفويض).

المستويات
https://www.googleapis.com/auth/yt-analytics.readonly عرض تقارير "إحصاءات YouTube" للمحتوى الخاص بك على YouTube يمنح هذا النطاق إمكانية الوصول إلى مقاييس نشاط المستخدمين، مثل أعداد المشاهدات وأعداد التقييمات.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly عرض تقارير "إحصاءات YouTube" المالية للمحتوى في YouTube يوفّر هذا النطاق إمكانية الوصول إلى مقاييس نشاط المستخدِم وإلى الأرباح المقدّرة وأداء الإعلانات.
https://www.googleapis.com/auth/youtube إدارة حسابك على YouTube في YouTube Analytics API، يستخدم مالكو القنوات هذا النطاق لإدارة المجموعات والعناصر المجمّعة في "إحصاءات YouTube".
https://www.googleapis.com/auth/youtubepartner عرض وإدارة مواد عرض YouTube والمحتوى المرتبط بها على YouTube في YouTube Analytics API، يستخدم مالكو المحتوى هذا النطاق لإدارة مجموعات "إحصاءات YouTube" والعناصر المجمّعة.

المعلمات

يسرد الجدول التالي المَعلمات التي يتيحها هذا طلب البحث. جميع المَعلمات المُدرَجة هي مَعلمات طلب بحث.

المعلمات
المَعلمات المطلوبة
groupId string
تحدّد المَعلمة id المعرّف الفريد للمجموعة التي تريد استرداد عناصر المجموعة إليها.
المَعلمات الاختيارية
onBehalfOfContentOwner string
لا يمكن استخدام هذه المَعلمة إلا في طلب مفوَّض بشكل صحيح. ملاحظة: هذه المَعلمة مخصّصة حصريًا لشركاء المحتوى في YouTube الذين يملكون ويديرون العديد من قنوات YouTube المختلفة.

تشير المَعلمة onBehalfOfContentOwner إلى أنّ بيانات اعتماد التفويض في الطلب تحدّد مستخدمًا على YouTube يتصرّف نيابةً عن مالك المحتوى المحدّد في قيمة المَعلمة. تتيح هذه الميزة لمالكي المحتوى المصادقة مرة واحدة والوصول إلى جميع بيانات الفيديوهات والقنوات، بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة على حدة. يجب أن يكون الحساب الذي يستخدمه المستخدم لتأكيد هويته مرتبطًا بحساب مالك المحتوى المحدّد على YouTube.

نص الطلب

لا تقدِّم محتوى طلب عند استدعاء هذه الطريقة.

الرد

إذا كانت الاستجابة ناجحة، تعرض هذه الطريقة نص استجابة بالبنية التالية:

{
  "kind": "youtube#groupItemListResponse",
  "etag": etag,
  "items": [
    groupItem Resource
  ]
}

أماكن إقامة

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

أماكن إقامة
kind string
لتحديد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#groupItemListResponse.
etag etag
رقم تعريف Etag لهذا المورد.
items[] list
قائمة بالعناصر التي تحتوي عليها المجموعة يمثّل كل عنصر في القائمة مورد groupItem.

الأخطاء

لا تحدِّد واجهة برمجة التطبيقات أي رسائل خطأ فريدة لهذه الطريقة. ومع ذلك، قد تظل هذه الطريقة تعرض أخطاء واجهة برمجة التطبيقات العامة المدرجة في وثائق رسالة الخطأ.

جرّب الآن

استخدِم APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات والاستجابة.