Playlists

يشير مورد playlist إلى قائمة تشغيل على YouTube. إنّ قائمة التشغيل عبارة عن مجموعة من الفيديوهات التي يمكن عرضها بشكل تسلسلي ومشاركتها مع مستخدمين آخرين. تكون قوائم التشغيل مرئية بشكل علني للمستخدمين الآخرين، ولكن يمكن أن تكون قوائم التشغيل علنية أو خاصة.

يستخدم YouTube أيضًا قوائم التشغيل لتحديد مجموعات خاصة من الفيديوهات في القناة، مثلاً:

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

يمكنك بعد ذلك استخدام الطريقة playlistItems.list لاسترداد أي من هذه القوائم. يمكنك أيضًا إضافة عناصر أو إزالتها من تلك القوائم عن طريق طلب الطريقتَين playlistItems.insert وplaylistItems.delete.

الطُرق

تتيح واجهة برمجة التطبيقات استخدام الطرق التالية لموارد playlists:

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

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

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

{   "kind": "youtube#playlist",   "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,     "defaultLanguage": string,     "localized": {       "title": string,       "description": string     }   },   "status": {     "privacyStatus": string,     "podcastStatus": enum   },   "contentDetails": {     "itemCount": unsigned integer   },   "player": {     "embedHtml": string   },   "localizations": {     (key): {       "title": string,       "description": string     }   } }

أماكن إقامة

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

أماكن إقامة
kind
string تحدد هذه السياسة نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#playlist.
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.tags[]
list تم إيقاف هذا الموقع نهائيًا.

علامات الكلمات الرئيسية المرتبطة بقائمة التشغيل.
snippet.defaultLanguage
string لغة النص في السمتَين snippet.title وsnippet.description للمورد playlist
snippet.localized
object يحتوي العنصر snippet.localized على عنوان ووصف مترجمَين لقائمة التشغيل أو على عنوان اللغة التلقائية للبيانات الوصفية لقائمة التشغيل.
  • يتم عرض نص مترجَم في مقتطف المورد إذا كان طلب playlists.list يستخدم مَعلمة hl لتحديد لغة يجب عرض النص المترجَم بها وكان النص المترجَم متاحًا بتلك اللغة.
  • يتم عرض البيانات الوصفية للغة التلقائية إذا لم يتم تحديد قيمة معلَمة hl أو تم تحديد قيمة ولكن البيانات الوصفية المترجَمة غير متاحة للغة المحدّدة.
يحتوي الموقع على قيمة للقراءة فقط. استخدِم عنصر localizations لإضافة عناوين مترجَمة أو تعديلها أو حذفها.
snippet.localized.title
string عنوان قائمة التشغيل المترجَم
snippet.localized.description
string تمثّل هذه السمة وصف قائمة التشغيل المترجَمة.
status
object يحتوي الكائن status على معلومات حالة قائمة التشغيل.
status.privacyStatus
string حالة خصوصية قائمة التشغيل.

في ما يلي القيم الصالحة لهذه السمة:
  • private
  • public
  • unlisted
status.podcastStatus
string حالة البودكاست في قائمة التشغيل إذا كانت القيمة enabled، يتم وضع علامة على قائمة التشغيل على أنّها عرض بودكاست. لضبط حالة البودكاست لقائمة التشغيل على enabled، يجب أن تتضمّن قائمة التشغيل صورة قائمة التشغيل.

في ما يلي القيم الصالحة لهذه السمة:
  • enabled
  • disabled
  • unspecified
contentDetails
object يتضمن العنصر contentDetails معلومات حول محتوى قائمة التشغيل، بما في ذلك عدد الفيديوهات فيها.
contentDetails.itemCount
unsigned integer عدد الفيديوهات في قائمة التشغيل
player
object يحتوي الكائن player على معلومات يمكنك استخدامها لتشغيل قائمة التشغيل في مشغل مضمّن.
player.embedHtml
string علامة <iframe> التي تضمّ مشغّلاً لتشغيل قائمة التشغيل
localizations
object يتضمن العنصر localizations ترجمات للبيانات الوصفية لقائمة التشغيل.
localizations.(key)
object لغة النص المترجم المرتبط بالقيمة الرئيسية. القيمة هي سلسلة تحتوي على رمز اللغة BCP-47.
localizations.(key).title
string عنوان قائمة التشغيل المترجَم
localizations.(key).description
string تمثّل هذه السمة وصف قائمة التشغيل المترجَمة.