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
تمثّل هذه السمة علامة 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
وصف قائمة التشغيل المترجَم