Playlists: update

لتعديل قائمة تشغيل. على سبيل المثال، يمكنك تغيير عنوان قائمة تشغيل أو وصفها أو حالة خصوصيتها.

تأثير الحصة: تبلغ تكلفة حصة الطلب الذي يتضمّن هذه الطريقة 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 التي يمكنك تضمينها في قيمة المَعلمة:
  • contentDetails
  • id
  • localizations
  • player
  • snippet
  • status
المَعلمات الاختيارية
onBehalfOfContentOwner
string لا يمكن استخدام هذه المَعلمة إلّا في طلب مفوَّض بشكل صحيح. ملاحظة: هذه المعلمة مخصصة حصريًا لشركاء المحتوى في YouTube.

تشير المعلمة onBehalfOfContentOwner إلى أن بيانات اعتماد التفويض الخاصة بالطلب تحدد هوية مستخدم نظام إدارة محتوى (CMS) في YouTube يتصرف بالنيابة عن مالك المحتوى المحدد في قيمة المعلمة. هذه المَعلمة مخصّصة لشركاء المحتوى في YouTube الذين يملكون العديد من القنوات المختلفة على YouTube ويديرونها. وهي تتيح لمالكي المحتوى إجراء مصادقة لمرة واحدة والوصول إلى جميع بيانات القناة والفيديوهات، بدون الحاجة إلى تقديم بيانات اعتماد مصادقة لكل قناة على حدة. يجب أن يكون حساب نظام إدارة المحتوى الذي يصادق عليه المستخدم مرتبطًا بحساب مالك محتوى YouTube المحدّد.

نص الطلب

قدِّم موردًا لقائمة التشغيل في نص الطلب. بالنسبة إلى هذا المورد:

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

    • id
    • snippet.title

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

    • snippet.title
    • snippet.description
    • status.privacyStatus
    • status.podcastStatus
    • 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 لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.