Playlists: update

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

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

حالات الاستخدام الشائعة

الطلب

طلب HTTP

PUT https://www.googleapis.com/youtube/v3/playlists

التفويض

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

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

نص الطلب

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

بالنسبة إلى هذا المرجع:

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

    • id
    • snippet.title

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

    • snippet.title
    • snippet.description
    • status.privacyStatus
    • status.podcastStatus
    • snippet.defaultLanguage
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

    إذا كنت بصدد إرسال طلب تعديل ولا يحدّد طلبك قيمة لسمة لها قيمة، سيتم حذف القيمة الحالية للسمة.

الردّ

إذا كانت الاستجابة ناجحة، تعرض هذه الطريقة مورد playlist في نص الاستجابة.

الأخطاء

يحدِّد الجدول التالي رسائل الخطأ التي يمكن أن تعرِضها واجهة برمجة التطبيقات استجابةً لطلب موجَّه إلى هذه الطريقة. لمزيد من التفاصيل، يُرجى الاطّلاع على YouTube Data API - Errors.

نوع الخطأ تفاصيل الخطأ الوصف
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 لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات والاستجابة.