يمثّل المرجع playlist
قائمة تشغيل على 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 في ما يلي قيم المفاتيح الصالحة:
|
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 إما على عنوان ووصف مترجَمَين لقائمة التشغيل أو عنوان باللغة التلقائية للبيانات الوصفية لقائمة التشغيل.
localizations لإضافة العناوين المترجَمة أو تعديلها أو حذفها. |
snippet.localized.title |
string تمثّل هذه السمة عنوان قائمة التشغيل المترجَمة. |
snippet.localized.description |
string وصف قائمة التشغيل المترجَمة |
status |
object يحتوي الكائن status على معلومات حالة قائمة التشغيل. |
status.privacyStatus |
string حالة خصوصية قائمة التشغيل القيم الصالحة لهذه السمة هي:
|
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 وصف قائمة التشغيل المترجَمة |