Для существующих интеграций, использующих API Tenor V1, выполните шаги на этой странице, чтобы перейти на V2.
Получите ключ API версии 2
Следуйте инструкциям на этапе настройки в кратком руководстве, чтобы получить ключ API версии 2 для замены вашей версии версии 1.
Обновление до доменов версии 2
Обновите домен API до https://tenor.googleapis.com/v2/
. API Tenor V2 поддерживает только соединения 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>
Чтобы обновить вызовы до версии 2, измените их на https://tenor.googleapis.com/v2/search? <parameters>
.
Изменения конечной точки
Большинство параметров конечных точек API не изменились по сравнению с тем, что задокументировано в версии 1. Есть несколько заметных исключений:
- Конечная точка поиска Tenor теперь поддерживает поиск стикеров с помощью параметра
searchfilter
. - Включите параметры
client_key
иcountry
в вызовы API. - Параметр
media_filter
теперь принимает список желаемых форматов, разделенных запятыми, а не предустановленные перечисления. - Конечная точка «Категории» теперь поддерживает
featured
иtrending
для параметраtype
. - API больше не поддерживает параметр
anon_id
. - Когда больше нет страниц результатов для запроса,
next
поле ответов API теперь представляет собой пустую строку, а не"0"
.
В доступные конечные точки внесены следующие изменения:
- Конечная точка Trending больше не поддерживается. Вместо этого мы рекомендуем вам использовать рекомендуемую конечную точку .
- Конечная точка GIF была переименована в конечную точку Posts .
- Конечная точка Random GIF была включена в конечную точку поиска с помощью параметра
random
.
Объект ответа и изменения ошибки
- Объект GIF был переименован в объект ответа .
- В объекте ответа поле
media
было переименовано вmedia_formats
. Значение дляmedia_formats
теперь представляет собой карту{ CONTENT_FORMAT : MEDIA_OBJECT }
, а не массив карт. - Предварительный просмотр миниатюр содержимого был перемещен из объекта мультимедиа для каждого формата содержимого в отдельный формат. Они предлагаются в поле
media_formats
в Response Object . - Когда в объекте ответа больше нет результатов,
next
поле представляет собой пустую строку""
, а не"0"
. - Коды ошибок Tenor API были перенесены в стандартные коды ошибок API Google.