将 Translator V2 迁移到 V3

注意

V2 已于 2018 年 4 月 30 日弃用。请将应用程序迁移到 V3，以便利用 V3 中专门提供的新功能。 V2 已于 2021 年 5 月 24 日停用。

翻译工具服务版本 3 (V3) 已正式发布。此版本包括新的功能、弃用了一些方法，并提供与 Microsoft 翻译工具服务相互发送和接收数据时所用的新格式。本文档提供有关将应用程序更改为使用 V3 的信息。

本文档末尾包含有用的链接，便于你了解详细信息。

功能摘要

无跟踪 - 在 V3 中，“无跟踪”将应用到 Azure 门户中的所有定价层。此功能意味着服务不会保存提交到 V3 API 的文本。
JSON - XML 替换 JSON。发送到服务的所有数据以及从服务接收的所有数据将采用 JSON 格式。
单个请求中的多个目标语言 - Translate 方法接受单个请求中的多个翻译目标 (to) 语言。例如，单个请求可以是从英语翻译到德语、西班牙语和日语，或任何其他语言组（from 到 to）。
双语字典 - 已将一个双语字典方法添加到 API。此方法包括 lookup 和 examples。
音译 - 已将一个 transliterate 方法添加到 API。此方法将一个脚本中的单词和句子转换为另一种脚本。例如，将阿拉伯语转换为拉丁语。
语言 - 新的 languages 方法以 JSON 格式提供语言信息，用于 translate、dictionary 和 transliterate 方法。
新的翻译功能 - 已将新功能添加到 translate 方法，以支持 V2 API 中作为单独方法提供的某些功能。示例包括 TranslateArray。
语音方法 - Microsoft 翻译工具不再支持文本转语音功能。 Microsoft 语音服务中提供了文本转语音功能。

以下 V2 和 V3 方法列表指明了能够提供 V2 随附的功能的 V3 方法和 API。

Microsoft Translator 翻译 V2 接受 XML 格式的数据，并以此格式返回数据。在 V3 中，使用 API 发送和接收的所有数据采用 JSON 格式。在 V3 中，不再接受或返回 XML 数据。

此更改会影响针对 V2 文本翻译 API 编写的应用程序的多个方面。例如：语言 API 返回文本翻译、音译和两个字典方法的语言信息。可以通过一次调用请求所有方法的所有语言信息，或单独请求这些方法的信息。

languages 方法不需要身份验证；选择以下链接可以看到 V3 的 JSON 格式的所有语言信息：

V3 接受用于 V2 的身份验证密钥。无需获取新订阅。在为期一年的迁移时间段内，可以在应用中混合使用 V2 和 V3，因此可以更轻松地发布新版本，同时从 V2-XML 迁移到 V3-JSON。

Microsoft Translator V3 的定价方式与 V2 相同：按字符（包括空格）计费。在哪些字符应该计费这一方面，V3 中的新功能做了一些改变。

V3 方法	应计费的字符
`Languages`	未提交任何字符：不计算字符数，免费。
`Translate`	根据提交翻译的字符数，以及字符要翻译成的语言数来统计费用。提交了 50 个字符，5 种语言计为 50x5。
`Transliterate`	根据提交音译的字符数统计费用。
`Dictionary lookup & example`	根据提交请求字典查找和示例的字符数统计费用。
`BreakSentence`	免费。
`Detect`	免费。