PlaylistImages: insert

تضيف هذه الطريقة صورة إلى قائمة تشغيل.

تتيح هذه الطريقة تحميل الوسائط. يجب أن تتوافق الملفات المحمّلة مع القيود التالية:

  • الحد الأقصى لحجم الملف: 50 ميغابايت
  • نسبة العرض إلى الارتفاع المقبولة: 1:1 (مربّع)
  • أنواع MIME للوسائط المقبولة: image/jpeg وimage/png

تأثير الحصة: تبلغ تكلفة الحصة لاستدعاء هذه الطريقة 50 وحدة.

طلب

طلب HTTP

POST 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 التي ستتضمّنها استجابة واجهة برمجة التطبيقات.

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

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

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

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

نص الطلب

قدِّم مورد playlistImages في نص الطلب.

بالنسبة إلى هذا المرجع:

  • يجب تحديد قيمة للسمات التالية:

    • snippet.playlistId
    • snippet.type

  • يمكنك ضبط قيم للخصائص التالية:

    • snippet.width
    • snippet.height

الردّ

إذا نجحت هذه الطريقة، ستعرض مورد playlistImages في نص الاستجابة.