Playlists: insert

لإنشاء قائمة تشغيل

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

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

الطلب

طلب HTTP

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

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

ملاحظة: هذه المَعلمة مخصّصة حصريًا لشركاء المحتوى في YouTube.


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

ملاحظة: هذه المَعلمة مخصّصة حصريًا لشركاء المحتوى في YouTube.


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

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

نص الطلب

قدِّم مورد playlist في نص الطلب. بالنسبة إلى هذا المرجع:

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

    • snippet.title

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

    • snippet.title
    • snippet.description
    • status.privacyStatus
    • 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 لاسترداد القيم الصالحة وتأكَّد من تعديلها باتّباع الإرشادات الواردة في مستندات مرجع قوائم التشغيل.
badRequest (400) maxPlaylistExceeded لا يمكن إنشاء قائمة التشغيل لأنّ القناة تحتوي حاليًا على الحد الأقصى المسموح به من قوائم التشغيل.
forbidden (403) playlistForbidden هذه العملية محظورة أو الطلب غير مفوَّض بشكل صحيح.
invalidValue (400) invalidPlaylistSnippet يقدّم الطلب مقتطفًا غير صالح من قائمة التشغيل.
required (400) playlistTitleRequired يجب أن يحدّد الطلب عنوان قائمة تشغيل.

جرّب الآن

استخدِم APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات والاستجابة.