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

الردّ

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