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 لغرضَين في هذه العملية. وتحدِّد هذه الطريقة السمات التي ستضبطها عملية write ، بالإضافة إلى الخصائص التي ستتضمّنها استجابة واجهة برمجة التطبيقات.

يُرجى العِلم أنّ هذه الطريقة ستلغي القيم الحالية للسمات القابلة للتغيير التي تكون مضمّنة في أي أجزاء يحدّدها نص الطلب. على سبيل المثال، يجب أن يكون وصف قائمة التشغيل مضمَّنًا في الجزء snippet، ويجب أن يكون مضمّنًا في نص الطلب. إذا لم يحدِّد الطلب قيمةً للسمة snippet.description، سيتم حذف الوصف الحالي لقائمة التشغيل.

تحتوي القائمة التالية على أسماء part التي يمكنك تضمينها في قيمة المَعلمة:
  • contentDetails
  • id
  • localizations
  • player
  • snippet
  • status
المَعلمات الاختيارية
onBehalfOfContentOwner string
لا يمكن استخدام هذه المَعلمة إلا في طلب معتمد بشكل صحيح. ملاحظة: هذه المَعلمة مخصّصة حصريًا لشركاء المحتوى في YouTube.

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