كيفية نقل البيانات من الإصدار 1 من واجهة برمجة تطبيقات Tenor

بالنسبة إلى عمليات الدمج الحالية التي تستخدم الإصدار 1 من واجهة برمجة التطبيقات Tenor API، اتّبِع الخطوات الواردة في هذه الصفحة للانتقال إلى الإصدار 2.

الحصول على مفتاح واجهة برمجة التطبيقات الإصدار 2

اتّبِع التعليمات الواردة في خطوة الإعداد من دليل التشغيل السريع للحصول على مفتاح الإصدار 2 من واجهة برمجة التطبيقات واستخدامه بدلاً من الإصدار 1.

الترقية إلى نطاقات الإصدار 2

عدِّل نطاق واجهة برمجة التطبيقات إلى https://tenor.googleapis.com/v2/. تتيح واجهة برمجة التطبيقات V2 من Tenor عمليات الربط عبر HTTPS فقط. بالنسبة إلى المحتوى، تأكَّد من أنّ تطبيقك يتيح تنزيل المحتوى من https://media.tenor.com وhttps://c.tenor.com.

على سبيل المثال، لنفترض أنّك أجريت طلب بيانات من واجهة برمجة التطبيقات إلى إحدى نطاقات الإصدار 1 التالية:

• https://api.tenor.com/v1/search?<parameters>
• https://g.tenor.com/v1/search?<parameters>

لتعديل عمليات الاستدعاء إلى الإصدار 2، غيِّرها إلى https://tenor.googleapis.com/v2/search?<parameters>.

تغييرات نقاط النهاية

لم تتغيّر معظم مَعلمات نقاط نهاية واجهة برمجة التطبيقات عن تلك الموضّحة في الإصدار 1. هناك بعض الاستثناءات المهمة:

1. تتيح نقطة نهاية البحث في Tenor الآن البحث عن الملصقات من خلال المَعلمة searchfilter.
2. تضمين المَعلمتَين client_key وcountry في طلبات البيانات من واجهة برمجة التطبيقات
3. تتلقّى المَعلمة media_filter الآن قائمة بالتنسيقات المطلوبة مفصولة بفواصل بدلاً من تعدادات محدّدة مسبقًا.
4. تتيح نقطة نهاية الفئات الآن استخدام featured وtrending للمعلَمة type.
5. لم تعُد واجهة برمجة التطبيقات تتيح المَعلمة anon_id.
6. عندما لا تتوفّر صفحات أخرى من النتائج لطلبها، يصبح الحقل next في ردود واجهة برمجة التطبيقات سلسلة فارغة بدلاً من "0".

تم إجراء التغييرات التالية على نقاط النهاية المتاحة:

1. لم يعُد نقطة النهاية Trending متاحة. بدلاً من ذلك، ننصحك باستخدام نقطة النهاية المميزة.
2. تمت إعادة تسمية نقطة نهاية GIF لتصبح نقطة نهاية "المشاركات".
3. تم دمج نقطة نهاية Random GIF في نقطة نهاية البحث من خلال المَعلمة random.

تغييرات في عنصر الاستجابة والخطأ

• تمت إعادة تسمية "كائن GIF" ليصبح كائن الردّ.
• في كائن الاستجابة، تم تغيير اسم الحقل media إلى media_formats. أصبحت قيمة media_formats الآن عبارة عن خريطة { CONTENT_FORMAT : MEDIA_OBJECT } بدلاً من مصفوفة من الخرائط.
• تم نقل معاينات الصور المصغّرة للمحتوى من عنصر الوسائط لكل تنسيق محتوى إلى تنسيق خاص بها. يتم تقديمها ضمن الحقل media_formats في كائن الرد.
• عندما لا تتوفّر نتائج أخرى في كائن الاستجابة، يكون الحقل next عبارة عن سلسلة فارغة، ""، بدلاً من "0".
• تم نقل رموز الخطأ في Tenor API إلى رموز الخطأ العادية في Google API.