升级至最新的图谱 API 版本

本指南介绍了如何让应用为测试不同版本的图谱 API 并升级至最新版本做准备。

API 升级工具显示了较新版本 API 中的更改可能会影响您应用中的哪些 API 调用。您可以快速了解将当前版本升级为较新版本所需要执行的更改。

了解更改对应用的影响

API 升级工具会显示一个自定义更改列表，让您了解升级到指定目标版本时会对应用产生何种影响。您可以通过此工具查看源版本和目标版本之间的所有相关更改。

第 1 步：在升级工具中，从下拉菜单中选择应用或输入应用名称。

下拉菜单最多只会列出十个应用。如需查看所列之外的更多应用，请使用下拉菜单中的搜索栏。

第 2 步：使用右侧下拉菜单，选择您用于升级的源版本和目标版本。

升级工具会显示将应用更新至选定 API 版本需要执行的更改的数量。如果您应用发出的 API 调用不会受到较新版本影响，则不会返回任何数据。

按影响调用的版本对方法进行颜色标记。将鼠标悬停在条形图上可查看各版本包含的更改量。与各版本关联的日期是指对所有应用执行更改的日期。

表格会显示更改的类型（弃用、新功能或更改）、受影响的方法、过去 7 天的调用量，以及受该特定更改影响的 API 调用所占比例。

注意：并非所有更改都会影响每个 API 调用。运用您的最佳判断来确定某项特定更改是否需要由您的应用处理。请务必在新版本中测试 API 调用，确保其能正常工作。

在应用面板的设置 > 高级中，滚动至升级 API 版本部分。

此操作会将应用的所有开发者和管理员升级至下一可用版本。同时，此操作亦可支持您在向公众发布新版本之前，借助少量的真实用户测试更改。

此操作会将应用执行的所有调用升级到下一可用版本。尽早升级十分实用，因为此时版本尚可返回至原始版本，可在出现不可预见的漏洞或问题时使用。