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

Playlists تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الطُرق

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

الخصائص

Playlists