翻譯工具 V2 到 V3 的移轉

注意

V2 已於 2018 年 4 月 30 日淘汰。請將您的應用程式遷移至 V3，以充分利用 V3 特有的新功能。 V2 已於 2021 年 5 月 24 日淘汰。

翻譯工具服務的版本 3 (V3) 已正式推出。此發行版本包含對 Microsoft Translator 服務傳送和接收資料的新功能、汰用方法和新格式。本文件提供將應用程式變更為使用 V3 的資訊。

本文件結尾處包含多個有用的連結，以供您深入了解。

功能摘要

無追蹤 - 在 V3 中，Azure 入口網站中的所有定價層都會套用「無追蹤」。此功能意味著服務不會儲存提交到 V3 API 的文字。
JSON - XML 取代 JSON。所有傳送至服務和從服務接收的資料均採用 JSON 格式。
單一要求中的多目標語言 -「翻譯」方法可接受在單一要求中使用多個 to 翻譯「目標」語言。例如，單一要求可以是from英文to和德文、西班牙文和日文或其他任何語言群組。
雙語字典 - API 中新增雙語字典方法。此方法包括 lookup 和 examples。
轉換 - API 中新增轉換方法。此方法會將一個指令碼中的單字和句子轉換到另一個指令碼。例如，阿拉伯文轉換為拉丁文。
語言 - 以 JSON 格式提供語言資訊的languages方法，適用於搭配 translate、dictionary 和 transliterate 方法。
新的翻譯功能 - translate 方法中新增新功能，用以支援在 V2 API 中作為個別方法的某些功能。例如，TranslateArray 就是其中之一。
語音方法 - Microsoft Translator 已不再支援文字轉換語音功能。 Microsoft 語音服務中有提供文字轉語音功能。

下列 V2 和 V3 方法清單列出提供 V2 隨附功能的 V3 方法和 API。

Microsoft Translator Translation V2 可接受及傳回 XML 格式的資料。在 V3 中，所有使用 API 傳送和接收的資料均採用 JSON 格式。在 V3 中不再接受或傳回 XML。

此變更將對為 V2 文字翻譯 API 撰寫的應用程式產生若干層面的影響。例如：語言 API 會傳回文字翻譯、音譯和兩個字典方法的語言資訊。您可以在單一呼叫中要求所有方法的所有語言資訊，或是個別要求。

語言方法不需要驗證，您只要選取以下連結，即可用 JSON 格式檢視 V3 的所有語言資訊：

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`	不收費。