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".

نص الطلب

يُرجى تقديم مورد playlistItem في نص الطلب. بالنسبة إلى هذا المورد:

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

    • id
    • snippet.playlistId
    • snippet.resourceId

  • يمكنك ضبط قيم للسمات التالية:

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

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

الردّ

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

الأخطاء

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

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