Translator V2 から V3 への移行
Note
V2 は、2018 年 4 月 30 日に非推奨となりました。 V3 で独占的に使用できる新しい機能を活用するためにアプリケーションを V3 に移行してください。 V2 は 2021 年 5 月 24 日に廃止されました。
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 を確認できます。
| V2 API メソッド | V3 API 互換性 |
|---|---|
Translate |
Translate |
TranslateArray |
Translate |
GetLanguageNames |
Languages |
GetLanguagesForTranslate |
Languages |
GetLanguagesForSpeak |
Microsoft Speech Service |
Speak |
Microsoft Speech Service |
Detect |
Detect |
DetectArray |
Detect |
AddTranslation |
この機能は現在サポートされていません |
AddTranslationArray |
この機能は現在サポートされていません |
BreakSentences |
BreakSentence |
GetTranslations |
この機能は現在サポートされていません |
GetTranslationsArray |
この機能は現在サポートされていません |
JSON 形式に移行
Microsoft Translator Translation V2 では、XML 形式でデータを受け取り、返しました。 V3 では、API を利用して送受信されるすべてのデータが JSON 形式になります。 XML は V3 では受け取られず、返されなくなります。
この変更は、V2 Text Translation API のために記述されたアプリケーションのいくつかの面に影響を与えます。 例Languages API は、テキスト翻訳メソッド、表記変換メソッド、2 か国語辞書メソッドの言語情報を返します。 1 回の呼び出しですべてのメソッドのすべての言語情報を要求するか、それらを個別に要求できます。
言語メソッドは認証を必要としません。次のリンクを選択すると、V3 の全言語情報を JSON で参照できます。
認証キー
V2 に使用される認証キーは、V3 で受け入れられます。 新しいサブスクリプションを取得する必要はありません。 移行期間が 1 年間続くとき、アプリで V2 と V3 を混在させることができるため、V2-XML から V3-JSON に移行しながら、新しいバージョンを簡単に公開することができます。
価格モデル
Microsoft Translator V3 の価格設定は V2 のときと同じであり、スペースを含む文字あたりとなります。 V3 に新機能が追加されたことで、課金対象となる文字の数え方にいくつかの変更があります。
| V3 メソッド | 課金対象となる文字数 |
|---|---|
Languages |
いかなる文字も送信されず、何も数えられず、何も課金されません。 |
Translate |
翻訳のために送信された文字の数と文字の翻訳先となる言語の数に基づいて数えられます。 50 文字が送信され、5 が 50x5 としてカウントされます。 |
Transliterate |
音訳のために送信された文字数が数えられます。 |
Dictionary lookup & example |
Dictionary の lookup と examples のために送信された文字数が数えられます。 |
BreakSentence |
課金はありません。 |
Detect |
課金はありません。 |
V3 エンド ポイント
グローバル
- api.cognitive.microsofttranslator.com
V3 API テキスト翻訳メソッド
互換性とカスタマイズ
Note
Microsoft Translator Hub は、2019 年 5 月 17 日をもって廃止されます。 重要な移行情報と日付を確認してください。
Microsoft Translator V3 では、ニューラル機械翻訳が既定で使用されます。 そのため、これは Microsoft Translator Hub では使用できません。 Translator Hub は、従来の統計的な機械翻訳のみをサポートしています。 ニューラル翻訳のカスタマイゼーションは、Custom Translator を使用してご利用いただけるようになりました。 ニューラル機械翻訳のカスタマイゼーションに関する詳細
V3 テキスト API によるニューラル翻訳では、標準カテゴリを使用できません (SMT、speech、tech、generalnn)。
| バージョン | エンドポイント | GDPR のプロセッサ準拠 | Translator Hub の使用 | カスタム トランスレーター (プレビュー) の使用 |
|---|---|---|---|---|
| Translator バージョン 2 | api.microsofttranslator.com | いいえ | 有効 | いいえ |
| Translator バージョン 3 | api.cognitive.microsofttranslator.com | はい | いいえ | はい |
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 ページを参照してください。