ドキュメント翻訳は、Foundry Tools のAzure Translatorのクラウドベースの機能です。 サポートされている言語とファイル形式全体で、非同期バッチ変換と同期単一ドキュメント翻訳がサポートされます。 ドキュメント翻訳ソフトウェア開発キット (SDK) は、これらの REST API 機能をアプリケーションに統合するのに役立ちます。
前提条件
ドキュメント翻訳 SDK を使用するには、次のものが必要です。
- アクティブな Azure サブスクリプション。
- 単一サービス Azure Translator リソース。
- Translator リソースのカスタム エンドポイントとキー。
- 非同期バッチ変換の場合、ソース コンテナーとターゲット コンテナーを含むAzure Blob Storage アカウント。 承認オプションについては、「 ストレージ コンテナーの承認」を参照してください。
サポートされている言語
ドキュメント翻訳 SDK では、次のプログラミング言語がサポートされています。
| 言語と SDK のバージョン | Package | クライアント ライブラリ | 既定の API バージョン |
|---|---|---|---|
.NET/C# 3.0.0 |
NuGet | Azure SDK for .NET | 2026-03-01 |
Python 2.0.0 |
PyPI | Python 用 Azure SDK | 2026-03-01 |
JavaScript/TypeScript 1.0.0 |
npm | JavaScript のAzure SDK | 2026-03-01 |
Java 2.0.0 |
Maven Central | JavaのAzure SDK | 2026-03-01 |
変更ログとリリース履歴
このセクションでは、ドキュメント翻訳機能と機能リリース、変更、更新プログラム、および拡張機能のバージョンベースの説明を提供します。
バージョン 3.0.0
変更ログ/リリース履歴
README
サンプル
アプリケーションでドキュメント翻訳 SDK を使用する
ドキュメント翻訳 SDK を使用すると、アプリケーションでの翻訳サービスの使用と管理が可能になります。 SDK は、プログラミング言語パラダイム内で使用するために、基になるドキュメント翻訳 REST API に基づいています。 好みのプログラミング言語を選択します。
1. SDK クライアント ライブラリをインストールする
dotnet add package Azure.AI.Translation.Document --version 3.0.0
Install-Package Azure.AI.Translation.Document -Version 3.0.0
2. SDK クライアント ライブラリをアプリケーションにインポートする
using System;
using Azure.Core;
using Azure.AI.Translation.Document;
3. クライアントを認証する
Document translation SDK と対話する DocumentTranslationClient オブジェクトのインスタンスを作成し、そのクライアント オブジェクトのメソッドを呼び出してサービスと対話します。
DocumentTranslationClientは、ドキュメント翻訳クライアント ライブラリを使用するための主要なインターフェイスです。 操作を実行するための同期メソッドと非同期メソッドの両方が提供されます。
非同期バッチ翻訳
private static readonly string endpoint = "<your-custom-endpoint>";
private static readonly string key = "<your-key>";
DocumentTranslationClient client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(key));
同期単一ドキュメント翻訳
private static readonly string endpoint = "<your-custom-endpoint>";
private static readonly string key = "<your-key>";
SingleDocumentTranslationClient client = new SingleDocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(key));
4. アプリをビルドする
非同期バッチ翻訳
ドキュメント変換バッチ インターフェイスには、次の入力が必要です。
- ファイルを Azure Blob Storage ソース コンテナー (sourceUri) にアップロードします。
- 翻訳されたドキュメントを書き込むことができるターゲット コンテナー (targetUri) を指定します。
- ターゲット言語コード (targetLanguage) を含めます。
Uri sourceUri = new Uri("<your-source-container-url>");
Uri targetUri = new Uri("<your-target-container-url>");
string targetLanguage = "<target-language-code>";
DocumentTranslationInput input = new DocumentTranslationInput(sourceUri, targetUri, targetLanguage);
同期単一ドキュメント翻訳
ヘルプ オプション
Microsoft Q&Aおよび Stack Overflow フォーラムは、開発者コミュニティが Azure Text 翻訳やその他のサービスに関する質問と回答を行うために利用できます。 Microsoft ではフォーラムを監視しており、コミュニティでまだ回答されていない質問に回答します。
ヒント
Microsoft Q&A の質問を確実に認識できるようにするために、microsoft-translator のタグを付けてください。
Stack Overflow の質問を確実に認識できるようにするために、Azure Translator のタグを付けてください。