PlaylistItems: insert

لإضافة مورد إلى قائمة تشغيل.

التأثير على الحصة: إنّ استدعاء هذه الطريقة له تكلفة حصة قدرها 50 وحدة.

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

طلب

طلب HTTP

POST https://www.googleapis.com/youtube/v3/playlistItems

التفويض

ويتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (اقرأ المزيد عن المصادقة والتفويض).

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

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

نص الطلب

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

  • يجب تحديد قيمة للخصائص التالية:

    • snippet.playlistId
    • snippet.resourceId

  • يمكنك تعيين قيم للخصائص التالية:

    • snippet.playlistId
    • snippet.position
    • snippet.resourceId
    • contentDetails.note
    • contentDetails.startAt
    • contentDetails.endAt

الإجابة

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

الأخطاء

يحدد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على استدعاء لهذه الطريقة. يرجى الاطلاع على وثائق رسالة الخطأ لمزيد من التفاصيل.

نوع الخطأ تفاصيل الخطأ الوصف
forbidden (403) playlistContainsMaximumNumberOfVideos تحتوي قائمة التشغيل على الحد الأقصى المسموح به لعدد العناصر.
forbidden (403) playlistItemsNotAccessible الطلب غير مصرح به بشكل صحيح لإدراج عنصر قائمة التشغيل المحدد.
invalidValue (400) invalidContentDetails الخاصية contentDetails في الطلب غير صالحة. من المحتمل أن يكون الحقل contentDetails.note أطول من 280 حرفًا.
invalidValue (400) invalidPlaylistItemPosition يحاول الطلب ضبط موضع عنصر قائمة التشغيل على قيمة غير صالحة أو غير متوافقة. تحقّق من قيمة السمة position في snippet للمورد.
invalidValue (400) invalidResourceType لا يتم توفير type المحددة لمعرّف المورد لهذه العملية. يحدد معرّف المورد العنصر الذي تتم إضافته إلى قائمة التشغيل – على سبيل المثال youtube#video.
invalidValue (400) manualSortRequired يحاول الطلب تعيين موضع عنصر قائمة التشغيل، ولكن لا تستخدم قائمة التشغيل التصنيف اليدوي. (على سبيل المثال، قد يتم ترتيب عناصر قائمة التشغيل بحسب التاريخ أو مدى الرواج). يمكنك معالجة الخطأ عن طريق إزالة العنصر snippet.position من المورد الذي يدرجه الطلب. إذا أردت أن يحصل عنصر قائمة التشغيل على موضع معيّن في القائمة، عليك أولاً تعديل خيار الترتيب في قائمة التشغيل إلى يدوي في إعدادات قائمة التشغيل. ويمكن تعديل هذه الإعدادات في مدير الفيديو في YouTube .
invalidValue (400) videoAlreadyInAnotherSeriesPlaylist الفيديو الذي تحاول إضافته إلى قائمة التشغيل موجود من قبل في قائمة تشغيل مقاطع فيديو متسلسلة أخرى.
notFound (404) playlistNotFound تعذّر العثور على قائمة التشغيل المحدّدة بالمَعلمة playlistId للطلب.
notFound (404) videoNotFound تعذر العثور على الفيديو الذي تحاول إضافته إلى قائمة التشغيل. تحقّق من قيمة السمة videoId للتأكّد من صحتها.
required (400) channelIdRequired لا يحدد الطلب قيمة للسمة channelId المطلوبة.
required (400) playlistIdRequired لا يحدد الطلب قيمة للسمة playlistId المطلوبة.
required (400) resourceIdRequired يجب أن يحتوي الطلب على مورد يحدّد فيه العنصر snippet resourceId.
invalidValue (400) playlistOperationUnsupported لا تتيح واجهة برمجة التطبيقات إمكانية إدراج مقاطع فيديو في قائمة التشغيل المحددة. على سبيل المثال، لا يمكنك إدراج فيديو في قائمة تشغيل الفيديوهات التي حمّلتها.

جرِّب هذه الميزة الآن.

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