الفيديو والترجمات · أداة تنزيل الصور المصغرة من YouTube وعارض البيانات الوصفية
كيف يقوم oEmbed بإرجاع العنوان العام للفيديو والقناة وكود التضمين
· كيف يعمل
يوتيوب oembed البيانات الوصفية
هناك طريقة قياسية وبدون مفاتيح لمطالبة موقع الفيديو بالعنوان العام للرابط ومؤلفه وتضمينه HTML. يشرح هذا المنشور oEmbed، كيف يبدو الطلب والاستجابة وكيف يمكن للأداة عرض البيانات التعريفية دون إلغاء الصفحة.
العنوان والقناة دون تحميل الصفحة — السؤال الذي تم تصميم oEmbed للإجابة عليه
يمكن للمدون معرفة العنوان الحالي لمقطع فيديو عام والقناة دون تحميل صفحة المشاهدة. يطلب ToolAcre من نقطة نهاية oEmbed في YouTube الحصول على سجل JSON منظم فقط بعد أن يضغط الزائر صراحةً على Fetch. ويمنع هذا التسلسل أيضًا الخلط بين البحث الفاشل في بيانات التعريف وبين URL المشوه، نظرًا لأن المرحلتين لهما أدلة مختلفة.
يتم تحليل الرابط أولاً في المتصفح. يقوم هذا الاختبار المبدئي بالتحقق من صحة المعرف واستخراجه دون الوصول إلى الشبكة، مما يحافظ على المدخلات المشوهة بعيدًا عن كل من مضيف الصور المصغرة ونقطة نهاية البيانات التعريفية. توفر نقطة النهاية تمثيلاً عامًا ضيقًا، وليس موجز بيانات للأغراض العامة أو آلية ترخيص.
ما هو oEmbed — معيار صغير حيث ينشر الموقع نقطة نهاية تجيب على "وصف هذا URL" مع JSON
oEmbed عبارة عن اتفاقية طلب واستجابة لوصف URL العام. هنا، يوفر YouTube نقطة نهاية تقبل الفيديو URL وترجع JSON الحقول المخصصة للتضمين والإسناد. يعد الاستعلام الدقيق مفيدًا في تتبع الشبكة لأنه يوضح المورد الأساسي المطلوب دون الكشف عن بيانات اعتماد الحساب.
يتعامل ToolAcre مع نقطة النهاية هذه كسقف وليس كمدخل للكشط. ولا يقوم بفحص صفحة المشاهدة HTML أو خدمات youtubei الداخلية أو التوقيعات أو أي شيء لا يمكن للطلب العام الذي تم تسجيل الخروج الوصول إليه. يمكن أن يكون الحقل موجودًا بشكل خام JSON ولا يزال يتم حذفه عمدًا من عقد التطبيق، لذا فإن التسوية هي قرار المنتج. يؤدي ذلك إلى منع الملاحظات النهائية من الاعتماد على الإضافات العرضية غير المقصودة.
الطلب — تم إرسال الفيديو URL ومعلمة التنسيق، لا أكثر، إلى youtube.com
ينتقل الطلب إلى https://www.youtube.com/oembed مع تعيين عنوان url على قيمة https://www.youtube.com/watch?v=ID الأساسية وتعيين التنسيق على json. لم تتم إضافة أي مفتاح API أو ملف تعريف ارتباط تسجيل الدخول أو الرمز المميز للحساب. وبالتالي فإن النتيجة الفارغة هي ملاحظة حدودية، وليست دليلاً على أن المعرف غير صالح أو أنه يجب إعادة محاولة البيانات المحمية.
يرسل المتصفح GET مجهولاً مع حذف بيانات الاعتماد، ولا يوجد مُحيل، ولا يوجد تخزين مؤقت في المتجر، وعمليات إعادة توجيه متبعة. يستلمها Google مع رأس Origin الخاص بها مباشرةً؛ ToolAcre لا يقوم بتشغيل أي خادم أو وكيل في هذا المسار. يؤدي هذا إلى الحفاظ على استقرار الصادرات عندما تحتوي الحمولات الأولية على حقول إضافية لا تتعهد الأداة بالحفاظ عليها.
تكشف الاستجابة المقيسة عن حقول البيانات التعريفية، وليس oEmbed HTML
المخطط التفصيلي الموعود المعروض يتضمن HTML، لكن NormalizeOembed يترك هذا الحقل خارجًا عمدًا. يحتوي الكائن الذي تمت تسويته على العنوان والقناة والقناة URL والصورة المصغرة URL والأبعاد وعرض المشغل وارتفاعه والموفر ومعرف الفيديو. يساعد تصنيف حالات الفشل بشكل منفصل المستخدم على تحديد ما إذا كان يريد إعادة المحاولة أو فحص الاستجابة أو اختيار مصدر آخر مسموح به.
يتم الدفاع عن كل قيمة: يحصل النص المفقود على بديل عادي، ويجب أن تكون الأبعاد موجبة، ويجب أن تكون الروابط HTTPS. وهذا يجعل تصدير JSON قابلاً للتنبؤ به دون الإشارة إلى أن كل خاصية oEmbed الأولية قد تم عرضها. يمكن فحص الطلب في DevTools، لكن سجل المتصفح لا يعني التخزين عن طريق ToolAcre أو المعالجة المحلية فقط.
لماذا لا تحتاج إلى مفتاح أو تسجيل دخول - البيانات عامة بالفعل على الصفحة؛ oEmbed يجعلها منظمة فقط
ليس هناك حاجة إلى مفتاح لأن هذه بيانات تعريف عامة تم تسجيل الخروج منها، ولكن العمومي لا يعني أنه عالمي. لا توفر مقاطع الفيديو الخاصة والمحذوفة والمقيدة بالفئة العمرية السجل، بينما يمكن للمالك الذي يعطل التضمين أن يتسبب في استجابة تفويض. لذلك، يجب على الناشر الذي يراجع طلبًا فاشلاً التحقق من توفر التضمين ورؤية الفيديو بدلاً من افتراض أن المعرف المكون من 11 حرفًا قد تم تحليله بشكل غير صحيح.
حدود الغياب واضحة: لا يتم تجميع أي مشاهدات أو إعجابات أو وصف أو علامات أو مدة أو تاريخ نشر أو تسميات توضيحية. لا تمنح نقطة النهاية الخالية من المفاتيح إمكانية الوصول إلى ما يتجاوز ما يختار YouTube نشره. إذا كان جدول البيانات التحريري يحتاج إلى تلك الحقول المحذوفة، فيجب على مؤلفه استخدام مصدر آخر مسموح به وتسمية هذا المصدر بدلاً من تقديم الفراغات كبيانات oEmbed.
مثال عملي: تعيين oEmbed JSON إلى سجل ToolAcre الذي تمت تسويته
للحصول على حمولة واحدة ناجحة، يتم تعيين العنوان للعنوان، واسم_المؤلف للقناة، واسم_المؤلف_لعنوان_القناة، وحقول الصور المصغرة لوصف الصورة المتداخلة، والعرض والارتفاع لأبعاد المشغل. يصبح Provide_name مزودًا. يمنح هذا التعيين أسماء تطبيقات مستقرة للصادرات على الرغم من أن اتفاقية المنبع تستخدم مصطلحات المؤلف لقناة YouTube.
قد يكون HTML الخام موجودًا في المنبع، لكن نتيجة ToolAcre والصادرات لا تكشفه. يقوم التطبيق بشكل منفصل بإنشاء إطار iframe سريع الاستجابة ومعزز للخصوصية من المعرف الذي تم التحقق من صحته، مما يتجنب الثقة غير المقصودة في ترميز نقطة النهاية. يتلقى المستهلكون حقائق يمكنهم اقتباسها أو إجراء تسلسل لها، بينما يظل ترميز التضمين القابل للتنفيذ خارج عقد البيانات التعريفية المقيسة.
ما لا يغطيه هذا هو عدد المشاهدات والأوصاف والتعليقات والتسميات التوضيحية وأي شيء وراء تسجيل الدخول
يمكن أن تفشل محاولة البيانات التعريفية قبل الاستجابة بسبب وضع عدم الاتصال أو أدوات الحظر أو الوكلاء؛ يمكن أن يفشل خلال الحالة HTTP؛ أو يمكنها إرجاع حالة نجاح بـ JSON غير صالح. يتلقى كل طريق رسالة مختلفة. يشير خطأ النقل إلى التحقق من بيئة المتصفح، بينما يحدد JSON غير الصالح الاستجابة التي وصلت ولكن لا يمكنها تلبية التنسيق الموعود لنقطة النهاية.
يعتبر فحص الصور المصغرة مستقلاً وقد يرى 404، أو خطأ آخر، أو عنصرًا نائبًا 200 أو بيانات غير قابلة للفك. لا يقوم أي فرع بتنزيل الفيديو ولا يتجاوز القيود المفروضة على المحتوى الخاص أو المحذوف أو المقيد بالفئة العمرية. يتيح الحفاظ على استقلالية الفروع للمحرر الاحتفاظ بالملصق الذي تم التحقق منه حتى لو كان إسناد العنوان غير متاح مؤقتًا، دون اختراع البيانات التعريفية المفقودة.
بيانات التعريف العامة المنظمة دون عرض تضمين نقطة النهاية HTML
والنتيجة هي بيانات تعريف عامة منظمة، وليست نسخة من oEmbed التعسفي HTML. يمكن لـ ToolAcre تصدير الحقائق التي تمت تسويتها كـ JSON أو Markdown أو CSV أو نص ويمكنه إنشاء روابط معروفة من المعرف الذي تم التحقق من صحته. يؤدي اختيار التصدير إلى تغيير العرض وليس النطاق: يعكس كل تنسيق نفس العنوان والقناة والصورة والمشغل والموفر وسجل المعرف.
بعد الجلب، تتكون حركة المرور من طلبات صور i.ytimg.com المباشرة وطلب oEmbed الأساسي الوحيد. تطلب حذف بيانات الاعتماد والمحيل، وتستخدم عمليات إعادة التوجيه بدون تخزين وعمليات إعادة التوجيه المتبعة، وتظل مرئية للتحقق في لوحة الشبكة بالمتصفح. يثبت هذا التتبع أن المتصفح اتصل بـ Google مباشرةً؛ ولا يُظهر ToolAcre تخزين البحث، ولا يجعل العملية محلية.