PlaylistItems: update

لتعديل عنصر قائمة تشغيل. على سبيل المثال، يمكنك تعديل موضع العنصر في قائمة التشغيل.

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