Translator V2 から V3 への移行

Translator サービスのバージョン 3 (V3) は一般提供されています。 このリリースには、新しい機能、非推奨になったメソッド、Microsoft Translator Service との間でデータを送受信するための新しい形式が含まれています。 このドキュメントでは、V3 を使用するためにアプリケーションを変更する方法に関する情報を提供します。

このドキュメントの終わりには、役に立つ詳細ページのリンクが記載されています。

機能のまとめ

• トレースなし - V3 では、Azure Portal の全価格レベルにトレースが適用されません。 この機能は、サービスが V3 API に送信されたテキストを保存しないことを意味します。
• JSON - JSON が XML に置き換えられます。 サービスに届くデータとサービスから届くデータはすべて JSON 形式になります。
• 1 回の要求で複数のターゲット言語 - Translate メソッドは、1 回の要求で複数の to (翻訳先) 言語に応じます。 たとえば、1 回の要求で from (翻訳元) を英語とし、to (翻訳先) にドイツ語、スペイン語、日本語、その他の言語グループを指定できます。
• 2 か国語辞書 - 2 か国語辞書メソッドが API に追加されました。 このメソッドには、lookup と examples が含まれます。
• 音訳 - 音訳メソッドが API に追加されました。 このメソッドは、あるスクリプト内の単語と文を別のスクリプトに変換します。 たとえば、アラビア語からラテン語などです。
• 言語 - 新しい languages メソッドは、translate、dictionary、および transliterate メソッドで使用するために、JSON 形式で言語情報を提供します。
• 翻訳の新機能 - 別のメソッドとして V2 API に存在した一部の機能に対応する目的で、新しい機能が translate メソッドに追加されました。 それには、たとえば、TranslateArray があります。
• 読み上げメソッド - テキスト読み上げ機能は、Microsoft Translator でサポートから外れました。 テキスト読み上げ機能は、Microsoft Speech Service で利用できます。

V2 メソッドと V3 メソッドについてまとめた次のリストで、V3 メソッドと、V2 に備わっていた機能を提供する API を確認できます。

JSON 形式に移行

Microsoft Translator Translation V2 では、XML 形式でデータを受け取り、返しました。 V3 では、API を利用して送受信されるすべてのデータが JSON 形式になります。 XML は V3 では受け取られず、返されなくなります。

この変更は、V2 Text Translation API のために記述されたアプリケーションのいくつかの面に影響を与えます。 例Languages API は、テキスト翻訳メソッド、表記変換メソッド、2 か国語辞書メソッドの言語情報を返します。 1 回の呼び出しですべてのメソッドのすべての言語情報を要求するか、それらを個別に要求できます。

言語メソッドは認証を必要としません。次のリンクを選択すると、V3 の全言語情報を JSON で参照できます。

https://api.cognitive.microsofttranslator.com/languages?api-version=3.0&scope=translation,dictionary,transliteration

認証キー

V2 に使用される認証キーは、V3 で受け入れられます。 新しいサブスクリプションを取得する必要はありません。 移行期間が 1 年間続くとき、アプリで V2 と V3 を混在させることができるため、V2-XML から V3-JSON に移行しながら、新しいバージョンを簡単に公開することができます。

価格モデル

Microsoft Translator V3 の価格設定は V2 のときと同じであり、スペースを含む文字あたりとなります。 V3 に新機能が追加されたことで、課金対象となる文字の数え方にいくつかの変更があります。

V3 エンド ポイント

グローバル

• api.cognitive.microsofttranslator.com

V3 API テキスト翻訳メソッド

Languages

Translate

Transliterate

BreakSentence

Detect

Dictionary/lookup

Dictionary/example

互換性とカスタマイズ

Microsoft Translator V3 では、ニューラル機械翻訳が既定で使用されます。 そのため、これは Microsoft Translator Hub では使用できません。 Translator Hub は、従来の統計的な機械翻訳のみをサポートしています。 ニューラル翻訳のカスタマイゼーションは、Custom Translator を使用してご利用いただけるようになりました。 ニューラル機械翻訳のカスタマイゼーションに関する詳細

V3 テキスト API によるニューラル翻訳では、標準カテゴリを使用できません (SMT、speech、tech、generalnn)。

Translator バージョン 3

• 一般提供されており完全にサポートされます。
• プロセッサとして GDPR に準拠し、ISO 20001 と 20018 のほか、SOC 3 認定要件をすべて満たしています。
• Translator の新しいニューラル機械翻訳 (NMT) カスタマイズ機能である Custom Translator (プレビュー) を使ってカスタマイズしたニューラル ネットワーク翻訳システムを呼び出すことができます。
• Microsoft 翻訳ツール Hub を使用して作成されたカスタム翻訳システムにアクセスすることはできません。

使用しているエンドポイントが api.cognitive.microsofttranslator.com である場合、ご使用の Translator のバージョンは 3 です。

Translator バージョン 2

• ISO 20001、20018、SOC 3 の認定要件をすべて満たしているわけではありません。
• Translator のカスタマイズ機能を使ってカスタマイズしたニューラル ネットワーク翻訳システムを呼び出すことはできません。
• Microsoft Translator Hub を使用して作成されたカスタム翻訳システムにアクセスできます。
• api.microsofttranslator.com エンドポイントを使用します。

どのバージョンの Translator でも、翻訳の記録は作成されません。 翻訳はだれとも共有されません。 詳細については、Translator の「トレースなし」という Web ページを参照してください。

リンク

• Microsoft プライバシーに関する声明
• Microsoft Azure の法的情報
• オンライン サービス規約

次のステップ