لتعديل عنصر قائمة تشغيل. على سبيل المثال، يمكنك تعديل موضع العنصر في قائمة التشغيل.
التأثير على الحصة: إنّ استدعاء هذه الطريقة له تكلفة حصة قدرها 50 وحدة.
حالات الاستخدام الشائعة
طلب
طلب HTTP
PUT 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 ، سيتم تعديل وقتي البدء والانتهاء لعنصر قائمة التشغيل إلى القيمة التي يحددها نص الطلب. في حال لم يحدِّد نص الطلب القيم، ستتم إزالة أوقات البدء والانتهاء الحالية واستبدالها بالإعدادات التلقائية.تحتوي القائمة التالية على أسماء part التي يمكنك تضمينها في قيمة المعلَمة:
|
|
المعلّمات الاختيارية | ||
onBehalfOfContentOwner |
string ملاحظة: إنّ المعلَمة onBehalfOfContentOwner مخصّصة حصريًا لشركاء المحتوى في YouTube ولا يمكن استخدامها إلا في طلب معتمد بشكل صحيح.تم تصميم هذه المعلمة لشركاء المحتوى في YouTube الذين يملكون قنوات YouTube مختلفة ويديرونها. وهي تتيح للمستخدمين التابعين لمالك المحتوى المصادقة مرة واحدة، ثم يتمكّنون بعد ذلك من الوصول إلى كل بيانات الفيديو والقناة الخاصة بمالك المحتوى وإدارتها، بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة على حدة. وعندما تكون المعلّمة موجودة، تحدد قيمتها مالك المحتوى، وتحدد بيانات اعتماد التفويض للطلب مستخدم YouTube المفوّض بالتصرف نيابةً عن مالك المحتوى هذا. يجب أن يكون الحساب الذي يجري المستخدم المصادقة عليه مرتبطًا بمالك المحتوى المحدّد في إعدادات استوديو YouTube لمبدعي المحتوى. |
نص الطلب
قدِّم موردItem في نص الطلب. بالنسبة إلى هذا المورد:
-
يجب تحديد قيمة للخصائص التالية:
id
snippet.playlistId
snippet.resourceId
-
يمكنك تعيين قيم للخصائص التالية:
snippet.position
contentDetails.note
contentDetails.startAt
contentDetails.endAt
إذا كنت ترسل طلب تعديل، ولم يحدّد طلبك قيمة لموقع يتضمّن قيمة من قبل، سيتم حذف القيمة الحالية للموقع.
الإجابة
وإذا تمّت العملية بنجاح، ستعرض هذه الطريقة مورد itemplaylist في نص الاستجابة.
الأخطاء
يحدد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على استدعاء لهذه الطريقة. يرجى الاطلاع على وثائق رسالة الخطأ لمزيد من التفاصيل.
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
الطلب غير مصرح به بشكل صحيح لتحديث عنصر قائمة التشغيل المحدد. |
invalidValue (400) |
invalidPlaylistItemPosition |
يحاول الطلب ضبط موضع عنصر قائمة التشغيل على قيمة غير صالحة أو غير متوافقة. تحقّق من قيمة السمة position في snippet للمورد. |
invalidValue (400) |
invalidResourceType |
لا يتم توفير type المحددة لمعرّف المورد لهذه العملية. يحدد معرّف المورد العنصر الذي تتم إضافته إلى قائمة التشغيل – على سبيل المثال youtube#video . |
invalidValue (400) |
invalidSnippet |
لا يحدد الطلب سمة snippet صالحة. |
invalidValue (400) |
manualSortRequired |
يحاول الطلب تعيين موضع عنصر قائمة التشغيل، ولكن لا تستخدم قائمة التشغيل التصنيف اليدوي. (على سبيل المثال، قد يتم ترتيب عناصر قائمة التشغيل بحسب التاريخ أو مدى الرواج). يمكنك معالجة الخطأ عن طريق إزالة العنصر snippet.position من المورد الذي يدرجه الطلب. إذا أردت أن يحصل عنصر قائمة التشغيل على موضع معيّن في القائمة، عليك أولاً تعديل خيار الترتيب في قائمة التشغيل إلى يدوي في إعدادات قائمة التشغيل. ويمكن تعديل هذه الإعدادات في مدير الفيديو في YouTube . |
notFound (404) |
playlistItemNotFound |
لا يمكن العثور على عنصر قائمة التشغيل الذي تم تحديده بخاصية id في الطلب. |
notFound (404) |
playlistNotFound |
تعذّر العثور على قائمة التشغيل المحدّدة بالمَعلمة playlistId للطلب. |
required (400) |
channelIdRequired |
لا يحدد الطلب قيمة للسمة channelId المطلوبة. |
required (400) |
playlistIdRequired |
لا يحدد الطلب قيمة للسمة playlistId المطلوبة. |
required (400) |
playlistItemIdRequired |
يجب أن يستخدم مورد عنصر قائمة التشغيل المحدّد في الطلب الخاصية id لتحديد عنصر قائمة التشغيل الذي يجري تحديثه. |
invalidValue (400) |
playlistOperationUnsupported |
لا تتيح واجهة برمجة التطبيقات إمكانية تحديث مقاطع الفيديو في قائمة التشغيل المحددة. على سبيل المثال، لا يمكنك تعديل فيديو في قائمة التشغيل التي حمّلتها. |
جرِّب هذه الميزة الآن.
يمكنك استخدام APIs Explorer لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.