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
  },
  "contentDetails": {
    "itemCount": unsigned integer
  },
  "player": {
    "embedHtml": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

أماكن إقامة

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

أماكن إقامة
kind	string تحدد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#playlist.
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.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
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 وصف قائمة التشغيل المترجَمة.