PlaylistImages: update

لتعديل صورة قائمة تشغيل.

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

الطلب

طلب HTTP

PUT 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 ملاحظة: إنّ المَعلمة onBehalfOfContentOwner مخصّصة حصريًا لشركاء المحتوى على YouTube ويمكن استخدامها فقط في طلب مصرّح به بشكل صحيح.

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

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

نص الطلب

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

بالنسبة إلى هذا المورد:

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

    • snippet.playlistId
    • snippet.type
  • يمكنك ضبط قيم لهذه السمات:

    • snippet.width
    • snippet.height

الرد

في حال نجاح هذه الطريقة، ستعرض هذه الطريقة مرجع قائمة التشغيل على عنصر قائمة التشغيل في نص الاستجابة.