لإضافة مورد إلى قائمة تشغيل.
التأثير على الحصة: إنّ استدعاء هذه الطريقة له تكلفة حصة قدرها 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 التي يمكنك تضمينها في قيمة المعلّمة:
|
|
المعلّمات الاختيارية | ||
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 لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.