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

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