تمت ترجمة هذه الصفحة بواسطة 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,
    "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` تمثّل هذه السمة وصف قائمة التشغيل المترجَمة.