PlaylistImages: list

تعرض هذه الطريقة مجموعة من صور قوائم التشغيل التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات. يمكنك استرداد صورة قائمة تشغيل محدّدة أو استرداد صورة واحدة أو أكثر من صور قوائم التشغيل من خلال معرّفاتها الفريدة.

تأثير الحصة: تبلغ تكلفة الحصة لطلب البيانات من هذه الطريقة وحدة واحدة.

طلب

طلب HTTP

GET https://www.googleapis.com/youtube/v3/playlistImages

التفويض

يتطلّب هذا الطلب الحصول على إذن باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات حول المصادقة ومنح الإذن).

النطاق
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

المعلمات

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

المعلمات
المَعلمات المطلوبة
part string

تحدّد المَعلمة part قائمة مفصولة بفواصل تتضمّن سمة واحدة أو أكثر من سمات المورد playlistImage التي ستتضمّنها استجابة واجهة برمجة التطبيقات.

إذا كانت المَعلمة تحدّد سمة تحتوي على سمات فرعية، سيتم تضمين السمات الفرعية في الاستجابة.
الفلاتر (حدِّد مَعلمة واحدة فقط من المَعلمات التالية)
id string
تحدّد المَعلمة id قائمة مفصولة بفواصل تتضمّن معرّفًا فريدًا واحدًا أو أكثر لصور قوائم التشغيل.
playlistId string
تحدّد المَعلمة playlistId المعرّف الفريد لقائمة التشغيل التي تريد استرداد صورها. يُرجى العِلم أنّه على الرغم من أنّ هذه المَعلمة اختيارية، يجب أن يحدّد كل طلب لاسترداد صور قوائم التشغيل قيمة إما للمَعلمة id أو للمَعلمة playlistId.
المَعلمات الاختيارية
maxResults unsigned integer
تحدّد المَعلمة maxResults الحد الأقصى لعدد الصور التي يجب عرضها في مجموعة النتائج. القيم المقبولة هي من 0 إلى 50، بشكلٍ شامل. القيمة التلقائية هي 5.
onBehalfOfContentOwner string
لا يمكن استخدام هذه المَعلمة إلا في طلب معتمَد بشكل صحيح. ملاحظة: هذه المَعلمة مخصّصة حصريًا لشركاء المحتوى في YouTube.

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

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

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

نص الطلب

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

الردّ

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

{
          "kind": "youtube#playlistImageListResponse",
          "nextPageToken": string,
          "prevPageToken": string,
          "pageInfo": {
            "totalResults": integer,
            "resultsPerPage": integer
          },
          "items": [
            playlistImages Resource
          ]
        }

الخصائص

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

الخصائص
kind string
تحدّد هذه السمة نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#playlistImageListResponse.
nextPageToken string
الرمز المميّز الذي يمكن استخدامه كقيمة للمَعلمة pageToken لاسترداد الصفحة التالية في مجموعة النتائج.
prevPageToken string
الرمز المميّز الذي يمكن استخدامه كقيمة للمَعلمة pageToken لاسترداد الصفحة السابقة في مجموعة النتائج.
pageInfo object
يحتوي العنصر pageInfo على معلومات حول تقسيم مجموعة النتائج إلى صفحات.
pageInfo.totalResults integer
تمثّل هذه السمة إجمالي عدد النتائج في مجموعة النتائج.
pageInfo.resultsPerPage integer
عدد النتائج المُضمَّنة في الردّ من واجهة برمجة التطبيقات.
items[] list
قائمة بصور قوائم التشغيل التي تطابق معايير الطلب