如何從 Tenor 的 V1 API 遷移

如果現有整合項目使用 Tenor 的 V1 API，請按照本頁面的步驟遷移至 V2。

取得 V2 API 金鑰

按照快速入門指南設定步驟中的說明，取得 V2 API 金鑰並取代 V1 版本。

更新至第 2 版網域

將 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 文件中記載的內容相同。但有幾個值得注意的例外情況：

1. Tenor 的搜尋端點現在支援透過 searchfilter 參數搜尋貼紙。
2. 在 API 呼叫中加入 client_key 和 country 參數。
3. media_filter 參數現在接受以半形逗號分隔的所需格式清單，而非預設列舉。
4. 類別端點現在支援 type 參數的 featured 和 trending。
5. API 不再支援 anon_id 參數。
6. 如果沒有更多結果頁面可供要求，API 回應的 next 欄位現在會是空白字串，而不是 "0"。

可用的端點已進行下列變更：

1. 系統不再支援熱門趨勢端點。建議改用精選端點。
2. GIF 端點已重新命名為貼文端點。
3. 隨機 GIF 端點已透過 random 參數併入搜尋端點。

回應物件和錯誤變更

• GIF 物件已重新命名為回應物件。
• 在回應物件中，media 欄位已重新命名為 media_formats。media_formats 的值現在是地圖 { CONTENT_FORMAT : MEDIA_OBJECT }，而不是地圖陣列。
• 內容縮圖預覽畫面已從每個內容格式的媒體物件移至專屬格式。這些值會顯示在回應物件的 media_formats 欄位下方。
• 如果回應物件中沒有其他結果，next 欄位會是空白字串 ""，而不是 "0"。
• Tenor API 錯誤代碼已遷移至 Google 的標準 API 錯誤代碼。