ドキュメント翻訳 SDK

ドキュメント翻訳は、Azure AI Translator サービスのクラウドベースの REST API 機能です。 ドキュメント翻訳 API を使用すると、サポートされている言語やさまざまなファイル形式で、ドキュメント翻訳全体を非同期的に迅速かつ正確にソースからターゲットにできます。 ドキュメント翻訳ソフトウェア開発キット (SDK) は、ドキュメント翻訳 REST API 機能をアプリケーションに簡単に統合できる一連のライブラリとツールです。

サポートされている言語

ドキュメント翻訳 SDK では、次のプログラミング言語がサポートされています。

言語 → SDK バージョン	パッケージ	クライアント ライブラリ	サポートされている API バージョン
.NET/C# → 1.0.0	NuGet	Azure SDK for .NET	ドキュメント翻訳 V1.1
Python → 1.0.0	PyPi	Azure SDK for Python	ドキュメント翻訳 V1.1

変更ログとリリース履歴

このセクションでは、ドキュメント翻訳機能のリリース、変更点、更新、機能強化に関するバージョンベースの説明を提供します。

C#/.NET

バージョン 1.0.0 (GA)
2022-06-07

変更ログ/リリース履歴

README

サンプル

Python

バージョン 1.0.0 (GA)
2022-06-07

変更ログ/リリース履歴

README

サンプル

アプリケーションでドキュメント翻訳 SDK を使用する

ドキュメント翻訳 SDK を使用すると、アプリケーションでドキュメント翻訳サービスを使用および管理できます。 SDK は、基になるドキュメント翻訳 REST API に基づいて構築されており、プログラミング言語パラダイム内で使用できます。 好みのプログラミング言語を選択します。

1. SDK クライアント ライブラリをインストールする

C#/.NET

dotnet add package Azure.AI.Translation.Document --version 1.0.0

Install-Package Azure.AI.Translation.Document -Version 1.0.0

Python

pip install azure-ai-translation-document==1.0.0

2. SDK クライアント ライブラリをアプリケーションにインポートする

C#/.NET

using System;
using Azure.Core;
using Azure.AI.Translation.Document;

Python

from azure.ai.translation.document import DocumentTranslationClient
from azure.core.credentials import AzureKeyCredential

3. クライアントを認証する

C#/.NET

Text 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));

Python

Text Translation SDK と対話する DocumentTranslationClient オブジェクトのインスタンスを作成し、続いてそのクライアント オブジェクトのメソッドを呼び出してサービスと対話します。 DocumentTranslationClient は、ドキュメント翻訳クライアント ライブラリを使用するための主要なインターフェイスです。 操作を実行するための同期メソッドと非同期メソッドの両方が提供されます。

endpoint = "<endpoint>"
key = "<apiKey>"

client = DocumentTranslationClient(endpoint, AzureKeyCredential(key))

4. アプリをビルドする

C#/.NET

ドキュメント翻訳インターフェイスには、次の入力が必要です:

1. ファイルを Azure Blob Storage ソース コンテナー (sourceUri) にアップロードします。
2. 翻訳されたドキュメントを書き込むことができるターゲット コンテナーを指定します (targetUri)。
3. ターゲット言語コード (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)

Python

ドキュメント翻訳インターフェイスには、次の入力が必要です:

1. ファイルを Azure Blob Storage ソース コンテナー (sourceUri) にアップロードします。
2. 翻訳されたドキュメントを書き込むことができるターゲット コンテナーを指定します (targetUri)。
3. ターゲット言語コード (targetLanguage) を含めます。

sourceUrl = "<your-source container-url>"
targetUrl = "<your-target-container-url>"
targetLanguage = "<target-language-code>"

poller = client.begin_translation(sourceUrl, targetUrl, targetLanguage)
result = poller.result()

ヘルプ オプション

開発者コミュニティで Azure Text Translation やその他のサービスに関する質問と回答を行うために、Microsoft Q&A と Stack Overflow フォーラムをご利用いただけます。 Microsoft ではフォーラムを監視しており、コミュニティでまだ回答されていない質問に回答します。

ヒント

Microsoft がお客様の Microsoft Q&A の質問を確実に認識できるように、microsoft-translator のタグを付けてください。 Stack Overflow の質問を確実に認識できるようにするために、Azure AI Translator のタグを付けてください。

次のステップ

ドキュメント翻訳 SDK クイック スタートドキュメント翻訳 v1.1 REST API リファレンス