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

المعلَمات

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

المعلَمات
المعلّمات المطلوبة
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 لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.