PlaylistItems

يحدّد المورد playlistItem موردًا آخر، مثل فيديو، مضمّن في قائمة تشغيل. بالإضافة إلى ذلك، يحتوي المرجع playlistItem على تفاصيل حول المورد المضمّن الذي يتعلق تحديدًا بكيفية استخدام هذا المورد في قائمة التشغيل هذه.

يستخدم YouTube أيضًا قائمة تشغيل لتحديد قائمة الفيديوهات التي تم تحميلها إلى القناة، ويمثّل كل منها playlistItem في هذه القائمة فيديو واحدًا تم تحميله إلى القناة. ويمكنك استرداد معرّف قائمة التشغيل لهذه القائمة من channel resource لقناة معيّنة. ويمكنك بعد ذلك استخدام طريقة playlistItems.list في القائمة.

الطُرق

تتوافق واجهة برمجة التطبيقات مع الطرق التالية لموردَين (playlistItems):

list

عرض مجموعة من عناصر قائمة التشغيل التي تطابق معلمات طلب واجهة برمجة التطبيقات. يمكنك استرداد كل عناصر قائمة التشغيل في قائمة تشغيل محدّدة أو استعادة عنصر أو أكثر من عناصر قائمة التشغيل حسب أرقام التعريف الفريدة الخاصة بها. التجربة الآن

إدراج

لإضافة مورد إلى قائمة تشغيل. التجربة الآن

تحديث

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

حذف

حذف عنصر قائمة تشغيل. التجربة الآن

تمثيل الموارد

تعرض بنية JSON التالية تنسيق مورد playlistItems:

{
  "kind": "youtube#playlistItem",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "videoOwnerChannelTitle": string,
    "videoOwnerChannelId": string,
    "playlistId": string,
    "position": unsigned integer,
    "resourceId": {
      "kind": string,
      "videoId": string,
    }
  },
  "contentDetails": {
    "videoId": string,
    "startAt": string,
    "endAt": string,
    "note": string,
    "videoPublishedAt": datetime
  },
  "status": {
    "privacyStatus": string
  }
}

أماكن إقامة

يحدد الجدول التالي الخصائص التي تظهر في هذا المورد:

أماكن إقامة
kind	string تحدد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#playlistItem.
etag	etag Etag لهذا المورد.
id	string المعرّف الذي يستخدمه YouTube لتحديد عنصر قائمة التشغيل بشكل فريد
snippet	object يحتوي الكائن snippet على تفاصيل أساسية حول عنصر قائمة التشغيل، مثل عنوانه وموضعه في قائمة التشغيل.
snippet.publishedAt	datetime تاريخ إضافة العنصر إلى قائمة التشغيل ووقته يتم تحديد القيمة بتنسيق ISO 8601.
snippet.channelId	string رقم التعريف الذي يستخدمه YouTube لتحديد المستخدم الذي أضاف العنصر إلى قائمة التشغيل بشكل فريد.
snippet.title	string عنوان العنصر
snippet.description	string وصف العنصر
snippet.thumbnails	object خريطة من الصور المصغّرة المرتبطة بعنصر قائمة التشغيل بالنسبة إلى كل كائن على الخريطة، يكون المفتاح هو اسم الصورة المصغّرة، والقيمة هي كائن يحتوي على معلومات أخرى حول الصورة المصغّرة.
snippet.thumbnails.(key)	object القيم الأساسية الصالحة هي: default – الصورة المصغرة الافتراضية. الصورة المصغرة الافتراضية لمقطع فيديو - أو مورد يشير إلى فيديو، مثل عنصر قائمة تشغيل أو نتيجة بحث - يبلغ عرضها 120 بكسل وطولها 90 بكسل. يبلغ عرض الصورة المصغّرة التلقائية للقناة 88 بكسل وطولها 88 بكسل. medium – نسخة بدقة أعلى من الصورة المصغّرة. بالنسبة إلى الفيديو (أو مورد يشير إلى فيديو)، يبلغ عرض هذه الصورة 320 بكسل وطولها 180 بكسل. بالنسبة إلى القناة، يبلغ عرض هذه الصورة 240 بكسل وطولها 240 بكسل. high – نسخة بدقة عالية من الصورة المصغّرة. بالنسبة إلى الفيديو (أو مورد يشير إلى فيديو)، يبلغ عرض هذه الصورة 480 بكسل وطولها 360 بكسل. بالنسبة إلى القناة، يبلغ عرض هذه الصورة 800 بكسل وطولها 800 بكسل. standard – نسخة بدقة أعلى من الصورة المصغّرة أعلى من الصورة ذات الدقة high. تتوفر هذه الصورة لبعض مقاطع الفيديو والموارد الأخرى التي تشير إلى مقاطع الفيديو، مثل عناصر قائمة التشغيل أو نتائج البحث. يبلغ عرض هذه الصورة 640 بكسل وطولها 480 بكسل. maxres – أعلى دقة للصورة المصغرة. يتوفر حجم الصورة هذا لبعض مقاطع الفيديو والموارد الأخرى التي تشير إلى مقاطع الفيديو، مثل عناصر قائمة التشغيل أو نتائج البحث. يبلغ عرض هذه الصورة 1280 بكسل وطولها 720 بكسل.
snippet.thumbnails.(key).url	string عنوان URL للصورة.
snippet.thumbnails.(key).width	unsigned integer عرض الصورة.
snippet.thumbnails.(key).height	unsigned integer ارتفاع الصورة
snippet.channelTitle	string عنوان القناة التي ينتمي إليها عنصر قائمة التشغيل
snippet.videoOwnerChannelTitle	string عنوان القناة التي حمّلت هذا الفيديو
snippet.videoOwnerChannelId	string معرّف القناة التي حمّلت هذا الفيديو
snippet.playlistId	string المعرّف الذي يستخدمه YouTube لتحديد قائمة التشغيل التي تتضمن عنصر قائمة التشغيل بشكل فريد
snippet.position	unsigned integer الترتيب الذي يظهر به العنصر في قائمة التشغيل تستخدم القيمة فهرسًا يستند إلى الصفر، لذلك يكون العنصر الأول هو 0، ويكون للعنصر الثاني موضع 1، وهكذا.
snippet.resourceId	object يحتوي الكائن id على معلومات يمكن استخدامها لتحديد المورد المضمّن في قائمة التشغيل كعنصر قائمة التشغيل بشكل فريد.
snippet.resourceId.kind	string نوع المورد المُحال أو نوعه.
snippet.resourceId.videoId	string إذا كانت قيمة السمة snippet.resourceId.kind هي youtube#video، ستكون هذه السمة موجودة وستحتوي قيمتها على المعرّف الذي يستخدمه YouTube لتعريف الفيديو في قائمة التشغيل بشكل فريد.
contentDetails	object يتم تضمين الكائن contentDetails في المورد إذا كان العنصر المضمن عبارة عن فيديو YouTube. يحتوي الكائن على معلومات إضافية حول الفيديو.
contentDetails.videoId	string المعرّف الذي يستخدمه YouTube لتعريف فيديو بشكل فريد لاسترداد مورد video، اضبط مَعلمة طلب البحث id على هذه القيمة في طلب البيانات من واجهة برمجة التطبيقات.
contentDetails.startAt	string ملاحظة: تم إيقاف هذه الخاصية، وفي حال ضبطها، سيتم تجاهل قيمتها. الوقت الذي تم قياسه بالثواني من بداية الفيديو وموعد بدء تشغيل الفيديو. (يمكن لمالك قائمة التشغيل تحديد أوقات بدء تشغيل الفيديو وإيقافه عند تشغيله في سياق قائمة التشغيل). القيمة التلقائية هي 0.
contentDetails.endAt	string ملاحظة: تم إيقاف هذه السمة، وفي حال ضبطها، سيتم تجاهل قيمتها. الوقت الذي تم قياسه بالثواني من بداية الفيديو وموعد إيقاف تشغيل الفيديو. (يمكن لمالك قائمة التشغيل تحديد أوقات بدء تشغيل الفيديو وإيقافه عند تشغيله في سياق قائمة التشغيل). بشكلٍ تلقائي، افترض أنّ video.endTime هو نهاية الفيديو.
contentDetails.note	string ملاحظة من إنشاء المستخدم لهذه السلعة يجب ألا يزيد طول قيمة الخاصية عن 280 حرفًا.
contentDetails.videoPublishedAt	datetime تاريخ نشر الفيديو على YouTube ووقت نشره يتم تحديد القيمة بتنسيق ISO 8601.
status	object يحتوي الكائن status على معلومات حول حالة خصوصية عنصر قائمة التشغيل.
status.privacyStatus	string حالة خصوصية عنصر قائمة التشغيل ويمكن للقناة التي حمّلت الفيديو الذي يمثّله عنصر قائمة التشغيل ضبط هذه القيمة باستخدام طريقة videos.insert أو طريقة videos.update.