بالنسبة إلى عمليات الدمج الحالية التي تستخدم 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. هناك بعض الاستثناءات البارزة:
- أصبحت نقطة نهاية البحث في Tenor متوافقة الآن مع البحث عن الملصقات من خلال معلَمة
searchfilter
. - ضمِّن المَعلمتَين
client_key
وcountry
في طلبات البيانات من واجهة برمجة التطبيقات. - أصبحت المَعلمة
media_filter
الآن تتضمّن قائمة بالتنسيقات المطلوبة مفصولة بفواصل بدلاً من التعدادات المُعدّة مسبقًا. - أصبحت نقطة نهاية الفئات متوافقة الآن مع
featured
وtrending
للمعلَمةtype
. - لم تعد واجهة برمجة التطبيقات تتيح المعلَمة
anon_id
. - في حال عدم توفّر صفحات إضافية لطلبها، يصبح حقل
next
في استجابات واجهة برمجة التطبيقات الآن سلسلة فارغة بدلاً من"0"
.
تم إجراء التغييرات التالية على نقاط النهاية المتاحة:
- لم تعد نقطة النهاية الرائجة متاحة. بدلاً من ذلك، ننصحك باستخدام نقطة نهاية مميّزة.
- تم تغيير العلامة التجارية لنقطة نهاية GIF إلى نقطة نهاية المشاركات.
- تم دمج نقطة نهاية GIF العشوائية في نقطة نهاية البحث من خلال المعلَمة
random
.
تغييرات في كائن الاستجابة والأخطاء
- تم تغيير العلامة التجارية لعنصر GIF إلى كائن الاستجابة.
- وفي
كائن الاستجابة، تم تغيير العلامة التجارية للحقل
media
لتصبحmedia_formats
. أصبحت قيمةmedia_formats
الآن خريطة{ CONTENT_FORMAT : MEDIA_OBJECT }
بدلاً من مصفوفة من الخرائط. - تم نقل معاينات الصورة المصغّرة للمحتوى من
كائن الوسائط
لكل تنسيق
محتوى إلى تنسيقه الخاص. ويتم عرضها ضمن الحقل
media_formats
في كائن الرد. - في حال عدم توفّر أي نتائج أخرى في عنصر الاستجابة، يكون الحقل
next
سلسلة""
فارغة بدلاً من"0"
. - تمّ نقل رموز خطأ واجهة برمجة تطبيقات Tenor إلى رموز الأخطاء العادية في Google API.