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

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` علامة هذا المرجع.
`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`.