كيفية نقل البيانات من واجهة برمجة التطبيقات V1 من Tenor

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

الحصول على مفتاح V2 API

اتَّبِع التعليمات الواردة في خطوة الإعداد ضمن دليل البدء السريع للحصول على مفتاح V2 لواجهة برمجة التطبيقات لاستبدال إصدار V1 الخاص بك.

التحديث إلى نطاقات V2

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

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

  • 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. لم تعد نقطة النهاية الرائجة متاحة. بدلاً من ذلك، ننصحك باستخدام نقطة نهاية مميّزة.
  2. تم تغيير العلامة التجارية لنقطة نهاية GIF إلى نقطة نهاية المشاركات.
  3. تم دمج نقطة نهاية GIF العشوائية في نقطة نهاية البحث من خلال المعلَمة random.

تغييرات في كائن الاستجابة والأخطاء

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