تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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