بيانات YouTube الوصفية

ما الذي يعيده oEmbed وما الذي يستبعده

oEmbed معيار عام صغير تستخدمه المواقع لوصف رابط حتى يتمكن موقع آخر من تضمينه. بالنسبة إلى فيديو YouTube، يعرض العنوان، واسم القناة وعنوان URL الخاص بها، ومشغل <iframe> جاهزًا، وصورة مصغرة واحدة، وهي صورة hqdefault بحجم 480 × 360. وهذا يكفي لإنشاء بطاقة رابط أو التحقق من القناة التي ينتمي إليها الرابط.

لا يتضمن عدد المشاهدات أو تاريخ الرفع أو المدة أو العلامات أو الوصف. تأتي هذه البيانات من YouTube Data API، الذي يحتاج إلى مفتاح API؛ أما للوصف وحده، فيقرأه مستخرج الوصف من صفحة المشاهدة العامة.

عندما يفشل البحث

لا يعيد الفيديو الخاص أو المحذوف أو الذي كُتب رابطه خطأً أي نتيجة، وينطبق الأمر نفسه على الفيديو الذي عطّل مالكه التضمين، لأن oEmbed يصف فقط الفيديوهات التي يمكن تضمينها في مواقع أخرى. تعمل الفيديوهات غير المدرجة عادةً، إذ يمكن لأي شخص يملك الرابط مشاهدتها. إذا فشل هنا رابط يعمل بصورة جيدة على YouTube، فالأرجح أن السبب هو قيود التضمين؛ وعندها سينشئ مولّد التضمين مشغلًا يعرض خطأً على المواقع الأخرى أيضًا.

طريقة الاستخدام

1. الصق رابط YouTube عامًا أو معرّف الفيديو.
2. اختر «قراءة البيانات الوصفية».
3. راجع العنوان والقناة والصورة المصغرة ومعرّف الفيديو والروابط.

الخصوصية والقيود

يُرسل الرابط إلى واجهة API الخاصة بـ TOEA وإلى نقطة نهاية البيانات الوصفية العامة في YouTube. لا يخزّن TOEA الرابط، ولا يسجّل الدخول إلى YouTube، ولا يكشف معلومات الفيديو الخاص.