PlaylistImages: insert

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

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

  • الحد الأقصى لحجم الملف: 2 ميغابايت
  • نسبة العرض إلى الارتفاع المقبولة: 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 إلى أنّ بيانات اعتماد التفويض المتعلّقة بالطلب تحدّد هوية مستخدم نظام إدارة محتوى (CMS) في 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 في نص الاستجابة.