PlaylistItems

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

تستخدم YouTube أيضًا قائمة تشغيل لتحديد قائمة الفيديوهات التي تم تحميلها في القناة، حيث يمثّل كل playlistItem في هذه القائمة فيديو واحدًا تم تحميله. يمكنك استرداد معرّف قائمة التشغيل لهذه القائمة من مورد channel للقناة المحدّدة. يمكنك بعد ذلك استخدام الطريقة 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.