如何从 Tenor V1 API 迁移

对于使用 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 中记录的参数没有变化。不过，也有一些值得注意的例外情况：

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 对象已重命名为 Response Object。
• 在响应对象中，media 字段已重命名为 media_formats。media_formats 的值现在是映射 { CONTENT_FORMAT : MEDIA_OBJECT }，而不是映射数组。
• 内容缩略图预览已从每种内容格式的媒体对象移至自己的格式。它们在响应对象中的 media_formats 字段下提供。
• 当响应对象中不再有结果时，next 字段是空字符串 ""，而不是 "0"。
• Tenor API 错误代码已迁移到 Google 的标准 API 错误代码。