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 في نص الطلب.
بالنسبة إلى هذا المورد:
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-16 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-08-16 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This method allows modification of a playlist image via the YouTube API."],["Utilizing this method incurs a quota cost of 50 units per call."],["Authorization is required, with scopes such as `https://www.googleapis.com/auth/youtubepartner`, `https://www.googleapis.com/auth/youtube`, or `https://www.googleapis.com/auth/youtube.force-ssl` being necessary."],["The `part` parameter is required, while `onBehalfOfContentOwner` is an optional parameter intended for YouTube content partners."],["The request body must contain a `playlistImages` resource with specified values for `snippet.playlistId` and `snippet.type`, and can optionally include `snippet.width` and `snippet.height`."]]],["This outlines how to modify a playlist image via the YouTube API. A `PUT` request is sent to `playlistImages`, costing 50 quota units. Authorization is required, utilizing scopes like `youtubepartner`. The request needs the `part` parameter and can optionally include `onBehalfOfContentOwner`. The request body requires `snippet.playlistId` and `snippet.type` properties and can optionally have `snippet.width` and `snippet.height` set. A successful request returns a `playlistItem` resource.\n"]]
