برای ادغامهای موجود که از Tenor's V1 API استفاده میکنند، مراحل موجود در این صفحه را برای انتقال به V2 دنبال کنید.
یک کلید API V2 دریافت کنید
دستورالعملهای مرحله راهاندازی راهنمای شروع سریع را دنبال کنید تا یک کلید API V2 برای جایگزینی نسخه V1 خود دریافت کنید.
بهروزرسانی به دامنههای V2
دامنه API خود را به https://tenor.googleapis.com/v2/
به روز کنید. Tenor's V2 API فقط از اتصالات HTTPS پشتیبانی می کند. برای محتوا، مطمئن شوید که برنامه شما از دانلود محتوا از https://media.tenor.com
و https://c.tenor.com
پشتیبانی می کند.
به عنوان مثال، فرض کنید یک تماس API با یکی از دامنه های V1 زیر برقرار کرده اید:
-
https://api.tenor.com/v1/search? <parameters>
-
https://g.tenor.com/v1/search? <parameters>
برای به روز رسانی تماس ها به V2، آنها را به https://tenor.googleapis.com/v2/search? <parameters>
.
نقطه پایانی تغییر می کند
اکثر پارامترهای نقطه پایانی API نسبت به آنچه در V1 مستند شده است، تغییری نکرده است. چند استثنا قابل توجه وجود دارد:
- اکنون Tenor's Search از جستجوی برچسب از طریق پارامتر
searchfilter
پشتیبانی می کند. - پارامترهای
client_key
وcountry
را در تماسهای API لحاظ کنید. - پارامتر
media_filter
اکنون یک لیست جدا شده با کاما از فرمت های مورد نظر را به جای شماره های از پیش تعیین شده می گیرد. - اکنون نقطه پایانی Categories از
featured
وtrending
پارامترtype
پشتیبانی میکند. - API دیگر از پارامتر
anon_id
پشتیبانی نمی کند. - وقتی دیگر صفحهای از نتایج برای درخواست وجود ندارد، فیلد
next
پاسخهای API اکنون به جای"0"
یک رشته خالی است.
تغییرات زیر در نقاط پایانی موجود اعمال شده است:
- نقطه پایان Trending دیگر پشتیبانی نمی شود. در عوض، توصیه می کنیم از نقطه پایانی ویژه استفاده کنید.
- نقطه پایانی GIF به عنوان نقطه پایانی Posts تغییر نام داده است.
- نقطه پایانی Random GIF از طریق پارامتر
random
در نقطه پایانی جستجو گنجانده شده است.
شی پاسخ و خطا تغییر می کند
- شیء GIF به Object Response تغییر نام داده است.
- در Response Object ، زمینه
media
به عنوانmedia_formats
تغییر نام داده شده است. اکنون مقدارmedia_formats
یک نقشه{ CONTENT_FORMAT : MEDIA_OBJECT }
است نه آرایه ای از نقشه ها. - پیش نمایش تصاویر کوچک محتوا از Media Object برای هر قالب محتوا به قالب خاص خود منتقل شده است. آنها تحت فیلد
media_formats
در Response Object ارائه می شوند. - هنگامی که هیچ نتیجه دیگری در یک شی پاسخ وجود ندارد، فیلد
next
یک رشته خالی است،""
و نه"0"
. - کدهای خطای Tenor API به کدهای خطای استاندارد API Google منتقل شدهاند.