لتعديل قائمة تشغيل. على سبيل المثال، يمكنك تغيير عنوان قائمة التشغيل أو وصفها أو حالة خصوصيتها.
التأثير على الحصة: إنّ استدعاء هذه الطريقة له تكلفة حصة قدرها 50 وحدة.
حالات الاستخدام الشائعة
طلب
طلب HTTP
PUT https://www.googleapis.com/youtube/v3/playlists
التفويض
ويتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (اقرأ المزيد عن المصادقة والتفويض).
النطاق |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
المعلَمات
يسرد الجدول التالي المعلمات التي يدعمها طلب البحث هذا. جميع المعلمات المدرجة هي معلمات طلب بحث.
المعلَمات | ||
---|---|---|
المعلّمات المطلوبة | ||
part |
string تستخدم المعلمة part غرضين في هذه العملية. وتحدّد هذه السمة الخصائص التي سيتم ضبطها من خلال عملية الكتابة، بالإضافة إلى الخصائص التي ستتضمنها استجابة واجهة برمجة التطبيقات.يُرجى ملاحظة أن هذه الطريقة ستحل محل القيم الحالية للمواقع القابلة للتغيير والمضمّنة في أي أجزاء يحددها نص الطلب. على سبيل المثال، يتم تضمين وصف قائمة التشغيل في الجزء snippet ، الذي يجب تضمينه في نص الطلب. إذا لم يحدّد الطلب قيمة للسمة snippet.description ، سيتم حذف الوصف الحالي لقائمة التشغيل.تحتوي القائمة التالية على أسماء part التي يمكنك تضمينها في قيمة المعلّمة:
|
|
المعلّمات الاختيارية | ||
onBehalfOfContentOwner |
string لا يمكن استخدام هذه المعلّمة إلا في طلب مفوَّض بشكلٍ سليم. ملاحظة: هذه المعلمة مخصصة حصريًا لشركاء محتوى YouTube. تشير المعلمة onBehalfOfContentOwner إلى أن بيانات اعتماد تفويض الطلب تحدد مستخدم YouTube CMS الذي يتصرف نيابةً عن مالك المحتوى المحدد في قيمة المعلمة. هذه المعلمة مخصصة لشركاء محتوى YouTube الذين يملكون ويديرون العديد من قنوات YouTube المختلفة. تتيح هذه الميزة لمالكي المحتوى المصادقة مرة واحدة والوصول إلى كل بيانات الفيديو والقناة بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة على حدة. يجب ربط حساب نظام إدارة المحتوى الذي يصادق المستخدم عليه بمالك محتوى YouTube المحدد. |
نص الطلب
قدِّم موردًا لقائمة التشغيل في نص الطلب. بالنسبة إلى هذا المورد:
-
يجب تحديد قيمة للخصائص التالية:
id
snippet.title
-
يمكنك تعيين قيم للخصائص التالية:
snippet.title
snippet.description
status.privacyStatus
snippet.defaultLanguage
localizations.(key)
localizations.(key).title
localizations.(key).description
إذا كنت ترسل طلب تعديل، ولم يحدّد طلبك قيمة لموقع يتضمّن قيمة من قبل، سيتم حذف القيمة الحالية للموقع.
الإجابة
وإذا نجحت هذه الطريقة، فيعرض مورد قائمة تشغيل في نص الاستجابة.
الأخطاء
يحدد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على استدعاء لهذه الطريقة. يرجى الاطلاع على وثائق رسالة الخطأ لمزيد من التفاصيل.
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
يجب ضبط defaultLanguage على تحديث localizations . |
badRequest (400) |
localizationValidationError |
تعذّر التحقق من إحدى القيم في كائن الأقلمة. استخدِم طريقة playlists.list لاسترداد القيم الصالحة واحرص على تعديلها باتّباع الإرشادات الواردة في مستندات موارد قوائم التشغيل. |
forbidden (403) |
playlistForbidden |
هذه العملية محظورة أو الطلب غير مصرح به بشكل صحيح. |
invalidValue (400) |
invalidPlaylistSnippet |
يقدم الطلب مقتطف قائمة تشغيل غير صالح. |
notFound (404) |
playlistNotFound |
تعذّر العثور على قائمة التشغيل المحدّدة بالمَعلمة id للطلب. |
required (400) |
playlistTitleRequired |
يجب أن يحدد الطلب عنوان قائمة التشغيل. |
invalidValue (400) |
playlistOperationUnsupported |
لا تتيح واجهة برمجة التطبيقات إمكانية تحديث قائمة التشغيل المحددة. على سبيل المثال، لا يمكنك تعديل خصائص قائمة التشغيل التي حمّلتها. |
جرِّب هذه الميزة الآن.
يمكنك استخدام APIs Explorer لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.