Vimeo API هي واجهة برمجة آلية تتيح لمستخدميها الوصول إلى تحميل ملفات الفيديو إلى منصة Vimeo من خلال تطبيقاتهم الخاصة. تتيح لك هذه الوظيفة أيضًا إدارة مقاطع الفيديو وتضمينها في موارد الويب الخاصة بك.
كيفية الحصول على مفتاح Vimeo API
الخطوة 1 – قم بإنشاء حساب
من أجل الوصول إلى أدوات مطور Vimeo ، يجب أن يكون لديك حساب مسجل في الخدمة نفسها. إذا كنت بالفعل عضوًا في النظام الأساسي ، فيمكنك الانتقال مباشرة إلى الخطوة 2. وإلا فانتقل إلى موقع مطوري Vimeo وانقر فوق “انضمام”.
يمكنك إنشاء ملف تعريف جديد باستخدام عنوان البريد الإلكتروني الخاص بك أو الاستمرار في حساب جوجل الخاص بك.
ثم سيُطلب منك تحديد كيف تريد استخدام فيديو Vimeo.
إذا لم تكن متأكدًا مما تختاره أو لا تريد الكشف عن هذا النوع من المعلومات ، فيمكنك الضغط على “تخطي”.
بعد ذلك سيتم توجيهك إلى الصفحة التي تحتوي على معلومات تسعير Vimeo حيث يمكنك رؤية الخطط والميزات المعروضة ، أو جرب عرضًا توضيحيًا أو اختر خطة مناسبة لنفسك.
الخطوة 2 – أدخل بوابة المطورين
بعد إنشاء حساب ، انتقل إلى بوابة المطورين واضغط على زر البدء.
الخطوة 3 – قم بإنشاء وتسجيل التطبيق الخاص بك
ثم سترى نموذجًا يتعين عليك تعبئته لإنشاء تطبيقك.
بعد تسجيل التطبيق الخاص بك ، يجب عليك إضافة بعض المعلومات إليه ، حتى تتمكن من إنشاء رمز الوصول الخاص بك.
اضغط على تعديل الإعدادات وأضف الوصف المختصر ورابطًا إلى موقع ويب تشغيل مشروعك واحفظ التغييرات.
الخطوة 4 – إنشاء رمز الوصول
بعد إضافة جميع المعلومات الضرورية ، ستتمكن من إنشاء رموز الوصول الخاصة بك لإجراء مكالمات إلى API Vimeo.
انقر فوق إنشاء رمز وصول أو مرر الصفحة لأسفل إلى قسم المصادقة.
حدد فئة رمز الوصول الذي تحتاج إلى إنشائه. هناك خياران متاحان – مصدق وغير مصدق. إذا قمت بتحديد مربع المصادقة ، فسيتعين عليك تحديد النطاقات التي ترغب في الوصول إليها. عند التمرير فوق كل خيار ، ستحصل على تلميح قصير.
في حالة احتياجك للوصول إلى بياناتك الخاصة ، لا تختر خيار إنشاء رمز غير مصادق. يحدد نوع رمز التفويض المميز المستخدمين النهائيين للتطبيق. اختيار رمز مميز غير مصادق يجعل مالك التطبيق هو المستخدم النهائي له.
بعد النقر فوق الزر “إنشاء” ، يتم عرض الرمز المميز الجديد في جدول “رموز الوصول الشخصية” أدناه.
كيفية استخدام Vimeo API
هذا هو RESTful API. هذا يعني أن معلمات Vimeo API تلتزم بمبادئ وممارسات REST للتفاعل مع الموارد عبر الإنترنت ، ومقاطع الفيديو في هذه الحالة ، باستخدام طرق HTTP القياسية ، بما في ذلك GET و POST و PATCH.
لبدء العمل مع Vimeo API ، عليك أولاً تسجيل التطبيق الخاص بك وإنشاء رمز وصول له. بعد ذلك ، قد تحتاج إلى إعداد بيئة تطوير للاتصال والتفاعل مع API. يقدم Vimeo الدعم الرسمي لما يقرب من اثنتي عشرة بيئة مطورة. يمكنك العثور على القائمة الكاملة لتلك في صفحة المكتبات ومجموعات تطوير البرامج . بعد ذلك يمكنك البدء في إجراء مكالمات إلى Vimeo API للتأكد من تكوين كل شيء بشكل صحيح.
أمثلة على Vimeo API
Vimeo Player API
هناك أيضًا خيار لاستخدام حل مشابه لمشغل Vimeo يسمى Player SDK. يتيح ذلك للمستخدم التفاعل مع مشغل Vimeo من خلال كود صفحة الويب الخاصة به. من الممكن تعديل مشغل الفيديو الافتراضي Vimeo API من حيث الميزات مثل التشغيل التلقائي ، والتكرار ، وأحداث التشغيل ، وحتى أبعاد المشغل على الشاشة وألوان التحكم.
Player SDK – مكتبة JavaScript – مستقلة عن API. تختلف خيارات الاتصال ، ويعطي الحل نطاقًا مختلفًا من الخيارات.
إذا كنت تريد التحكم الكامل في مقاطع فيديو Vimeo المضمنة في موقع الويب الخاص بك ، فجرّب أداة Vimeo Player الجاهزة للاستخدام على موقع الويب الخاص بك!
Vimeo Embed API
يمكنك تضمين مقاطع الفيديو من منصة Vimeo باستخدام المعيار المفتوح لـ oEmbed بدلاً من API. يوفر طريقة سهلة لوضع مقاطع فيديو Vimeo على مواقع الويب الخارجية. عند الحصول على عنوان URL خاص يتوافق مع المحتوى الذي تريد تضمينه ، يتم تزويدك بمعلومات مفصلة عن هذا المحتوى مع عنصر <iframe> قابل للتضمين.
تحميل Vimeo API
تتميز Vimeo API بمجموعة كاملة من الوظائف لتحميل ملفات الفيديو وإدارتها. باستخدام هذا الحل ، من الممكن الوصول إلى إمكانات التحميل الخاصة بـ Vimeo من خلال الواجهة الأمامية للتطبيق الخاص بالمستخدم. لهذا تحتاج إلى رمز وصول مع نطاقات التحميل والتحرير. لاحظ أيضًا أنه لكي يتمكن التطبيق من تحميل مقاطع الفيديو إلى Vimeo ، تحتاج إلى تشغيل الوصول إلى التحميل – لا يتم تمكين هذا الخيار افتراضيًا.
لتمكين وصول التحميل ، قم بما يلي:
- قم بزيارة صفحة تطبيقاتي.
- انقر فوق التطبيق الخاص بك للذهاب إلى صفحة المعلومات الخاصة به.
- ابحث عن قسم الوصول إلى التحميل في قائمة المعلومات العامة وانقر على رابط طلب الوصول إلى التحميل.
- قدم عدة إجابات حول تطبيق Vimeo API الخاص بك.
- انقر فوق خيار طلب الوصول إلى التحميل.
أحدث تغييرات وحدود API
توفر الوثائق معلومات مفصلة حول إصدارات Vimeo API والتغييرات التي تم تنفيذها. في قسم Vimeo API Changelog ، تم وصف الإصدارات من 3.0 إلى 3.4 – وهي النسخة قيد التشغيل حاليًا من واجهة البرمجة.
تتضمن Vimeo API حدودًا معينة للسعر – وهذا يعني الحد الأقصى لعدد المكالمات التي يمكن لتطبيقك إجراؤها لواجهة برمجة التطبيقات في الدقيقة. إذا تجاوز أي مستخدم هذا الحد ، فإن منصة Vimeo تضع التطبيق في فترة السكون للمستخدم. ثم يتعين على المستخدم الانتظار حتى يتم إعادة تعيين الحد ويمكنه تقديم طلبات جديدة عبر التطبيق.
تعتمد كمية المكالمات التي يمكن للمستخدم إجراؤها في الدقيقة على نوع عضويته في Vimeo. يمكنك رؤية العدد التفصيلي للمكالمات في الجدول أدناه.
| عضوية المستخدم النهائي الخاص بك | طلبات API في الدقيقة (لكل مستخدم) |
| فيميو بيسك | 25 |
| فيميو بلس | 125 |
| فيميو برو | 250 |
| فيميو بيزنس | 500 |
| فيميو بريميوم | 750 |
| مؤسسة فيميو | 2500 |
وثائق Vimeo API
يمكن الوصول إلى قسم التوثيق بسهولة من بوابة مطوري Vimeo. يتميز بدليل المبتدئين ، ويغطي جميع حلول البرمجة الرئيسية مثل SDK و oEmbed للعمل مع محتوى Vimeo. وهناك أيضا تطورا API المرجعي ، التغيير و دعم أقسام.