翻譯工具 V2 到 V3 的移轉

注意

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

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

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

功能摘要

無追蹤 - 在 V3 中，Azure 入口網站中的所有定價層都會套用「無追蹤」。此功能表示 Microsoft 將不會儲存任何提交至 V3 API 的文字。
JSON - XML 已由 JSON 取代。所有傳送至服務和從服務接收的資料均採用 JSON 格式。
單一要求中的多目標語言 -「翻譯」方法可接受在單一要求中使用多個翻譯「目標」語言。例如，單一要求可用英文作為「來源」語言，並以德文、西班牙文和日文或其他任何語言群組作為「目標」語言。
雙語字典 - API 中新增了雙語字典方法。此方法包含「查閱」和「範例」。
音譯 - API 中新增了音譯方法。此方法會將一個指令碼中的單字和句子轉換到另一個指令碼。例如，阿拉伯文轉換為拉丁文。
語言 - 新的「語言」方法提供 JSON 格式的語言資訊，可與「翻譯」、「字典」和「音譯」等方法搭配使用。
新的翻譯功能 - 「翻譯」方法中新增了新功能，用以支援在 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`	不收費。