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

يُرجى العِلم أنّ هذه الطريقة ستلغي القيم الحالية لكل السمات القابلة للتغيير والمضمَّنة في أي أجزاء تحدِّدها قيمة المَعلمة. على سبيل المثال، يمكن أن يحدد عنصر قائمة التشغيل وقت البدء ووقت الانتهاء، واللذين يحددان جزء أوقات الفيديو الذي يجب تشغيله عندما يشاهد المستخدمون الفيديو في قائمة التشغيل. إذا كان طلبك يعدِّل عنصر قائمة تشغيل يضبط هذه القيم، وكانت قيمة المَعلمة part للطلب تتضمّن الجزء contentDetails، سيتم تعديل وقت بدء هذا العنصر ووقت انتهائه إلى أي قيمة يحدّدها نص الطلب. إذا لم يحدِّد نص الطلب قيمًا، ستتم إزالة وقتَي البدء والانتهاء الحاليين واستبدالهما بالإعدادات التلقائية.

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

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

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

نص الطلب

قدِّم مورد قائمة التشغيل في نص الطلب. بالنسبة لهذا المورد:

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

    • id
    • snippet.playlistId
    • snippet.resourceId

  • ويمكنك ضبط قيم لهذه المواقع الإلكترونية:

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

    إذا كنت تُرسل طلب تعديل ولم يحدِّد طلبك قيمة لموقع يحتوي على قيمة، سيتم حذف القيمة الحالية للموقع.

الإجابة

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

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
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 لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.