Tenor の V1 API を使用する既存の統合の場合は、このページの手順に従って V2 に移行してください。
V2 API キーを取得する
クイックスタート ガイドのセットアップ手順に沿って、V2 API キーを取得して、V1 のバージョンを置き換えます。
V2 ドメインへの更新
API ドメインを https://tenor.googleapis.com/v2/ に更新します。Tenor の V2 API は HTTPS 接続のみをサポートしています。コンテンツの場合は、アプリが https://media.tenor.com と https://c.tenor.com からのコンテンツのダウンロードをサポートしていることを確認します。
たとえば、次のいずれかの V1 ドメインに対して API 呼び出しを行うとします。
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 の検索エンドポイントは、
searchfilterパラメータによるステッカー検索をサポートするようになりました。 - API 呼び出しに
client_keyパラメータとcountryパラメータを含めます。 media_filterパラメータは、プリセットの列挙型ではなく、目的の形式のカンマ区切りのリストを使用するようになりました。- カテゴリのエンドポイントで、
typeパラメータにfeaturedとtrendingがサポートされるようになりました。 - API で
anon_idパラメータがサポートされなくなりました。 - リクエストする結果ページがない場合、API レスポンスの
nextフィールドは、"0"ではなく空白の文字列になりました。
使用可能なエンドポイントに次の変更が加えられました。
- [急上昇] エンドポイントはサポートされなくなりました。代わりに、注目のエンドポイントを使用することをおすすめします。
- GIF エンドポイントは、投稿エンドポイントにリブランディングされました。
- ランダム GIF エンドポイントは、
randomパラメータによって検索エンドポイントに組み込まれています。
レスポンス オブジェクトとエラーの変更
- GIF オブジェクトは Response Object にリブランディングされました。
- レスポンス オブジェクトの
mediaフィールドはmedia_formatsに名称変更されました。media_formatsの値は、マップの配列ではなく、マップの{ CONTENT_FORMAT : MEDIA_OBJECT }になりました。 - コンテンツ サムネイルのプレビューが、各コンテンツ形式のメディア オブジェクトから独自の形式に移動しました。レスポンス オブジェクトの
media_formatsフィールドで指定できます。 - レスポンス オブジェクトで結果がなくなると、
nextフィールドは"0"ではなく、空の文字列""になります。 - Tenor API のエラーコードは、Google の標準の API エラーコードに移行されました。