作業の開始: ドキュメント翻訳クライアントライブラリ

2025-04-14

ドキュメント翻訳は、サポートされている言語とさまざまなファイル形式でドキュメント全体を非同期的に翻訳する、Azure AI Translator サービスのクラウドベースの機能です。このクイックスタートでは、構造とテキストの書式設定を維持しながら、選択したプログラミング言語でドキュメント翻訳を使用して、ソースドキュメントをターゲット言語に翻訳する方法について説明します。

重要

ドキュメント翻訳は現在、Azure AI Translator (単一サービス) リソースでのみサポートされており、Azure AI サービス (マルチサービス) リソースには含 まれていません 。
ドキュメント翻訳は有料レベルでサポートされています。 Language Studio では、S1 または D3 のインスタンス層がサポートされます。ドキュメント翻訳を試すには、Standard S1 を選択することをお勧めします。「Azure AI 翻訳の価格」を "参照してください"。
ドキュメント翻訳のパブリックプレビューリリースでは、開発中の機能に早期にアクセスできます。機能、アプローチ、およびプロセスは、一般提供 (GA) リリースの前に、ユーザーからのフィードバックに基づいて変更される可能性があります。
ドキュメント翻訳クライアントライブラリのパブリックプレビューバージョンは、REST API バージョン 2024-05-01 に既定で設定されています。

前提条件

開始するには、以下が必要です。

アクティブな Azure アカウント。アカウントがない場合は、無料アカウントを作成できます。
単一サービスの Azure AI Translator リソース (マルチサービスの Azure AI Foundry リソースではありません)。マネージド ID 承認でドキュメント変換機能の使用を計画している場合は、米国東部などの地理的リージョンを選択します。 Standard S1 Standard サービスプランまたは C2、C3、C4、または D3 ボリューム割引プランを選択します。
Azure Blob Storage アカウント。 Azure Blob Storage アカウント内に、ソースおよびターゲットファイル用のコンテナーを作成します。
- ソースのコンテナー。このコンテナーは、翻訳対象のファイルをアップロードする場所です (必須)。
- ターゲットのコンテナー。このコンテナーは、翻訳されたファイルを格納する場所です (必須)。

ストレージコンテナーの承認

Azure AI Translator リソースへのアクセスを承認するには、次のいずれかのオプションを選択できます。

✔️マネージド ID。マネージド ID は、Microsoft Entra ID と、Azure 管理対象リソースの固有アクセス許可を作成するサービスプリンシパルです。マネージド ID を使用すると、コードに資格情報を埋め込む必要なく、Azure AI Translator アプリケーションを実行できます。マネージド ID は、ストレージデータへのアクセスを許可し、ソース URL とターゲット URL に Shared Access Signature トークン (SAS) を含めるように要件を置き換えるためのより安全な方法です。

詳細については、「ドキュメント翻訳のマネージド ID」を参照してください。

マネージド ID のフロー (RBAC) のスクリーンショット。

✔️ Shared Access Signature (SAS)。共有アクセス署名は、Translator サービスに対して、指定した期間の制限付きアクセスを許可する URL です。この方法を使うには、ソースおよびターゲットコンテナー用に Shared Access Signature (SAS) トークンを作成する必要があります。 sourceUrl と targetUrl には Shared Access Signature (SAS) トークンを含める必要があり、クエリ文字列として追加します。トークンは、コンテナーまたは特定の BLOB に割り当てることができます。

ソースのコンテナーまたは BLOB には、読み取りと一覧表示のアクセス権が指定されている必要があります。
ターゲットのコンテナーまたは BLOB には、書き込みと一覧表示のアクセス権が指定されている必要があります。

詳細については、「SAS トークンの作成」をご覧ください。

SAS トークンを含むリソース URI のスクリーンショット。

アプリケーションをビルドする

Translator C#/.NET アプリケーションの作成、ビルド、実行に使用できるツールがいくつかあります。ここでは、コマンドラインインターフェイス (CLI) または Visual Studio を使用する方法について説明します。開始するには、次のいずれかのタブを選択します。

.NET CLI
Visual Studio

プロジェクトの設定

コンソールウィンドウ (cmd、PowerShell、Bash など) で、dotnet new コマンドを使用し、batch-document-translation という名前で新しいコンソールアプリを作成します。このコマンドにより、1 つのソースファイルを使用する単純な "Hello World" C# プロジェクトが作成されます。Program.cs。

dotnet new console -n batch-document-translation

新しく作成されたアプリフォルダーにディレクトリを変更します。次のコマンドでアプリケーションをビルドします。

dotnet build

ビルドの出力に警告やエラーが含まれないようにする必要があります。

...
Build succeeded.
 0 Warning(s)
 0 Error(s)
...

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

アプリケーションディレクトリ内に、.NET 用のドキュメント変換クライアントライブラリをインストールします。

dotnet add package Azure.AI.Translation.Document --version 2.0.0-beta

ドキュメントを非同期で翻訳する

このプロジェクトでは、ソースコンテナーにアップロードされたソースドキュメントが必要です。このクイックスタートでは、ドキュメント翻訳のサンプルドキュメントをダウンロードできます。ソース言語は英語です。
プロジェクトディレクトリから、好みのエディターまたは IDE で Program.cs ファイルを開きます。行 Console.WriteLine("Hello World!")を含め、既存のコードを削除します。
アプリケーションの Program.cs で、対象のキーとカスタムエンドポイントの変数を作成します。詳細については、「キーとカスタムドメインエンドポイントを取得する」をご覧ください。
```
private static readonly string endpoint = "<your-document-translation-endpoint>";
private static readonly string key = "<your-key>";
```
StartTranslationAsync メソッドを呼び出して、1 つの BLOB コンテナー内の 1 つ以上のドキュメントについて翻訳操作を開始します。

StartTranslationAsync を呼び出すには、以下の DocumentTranslationInput、sourceUri、targetUri パラメーターを含む targetLanguageCode オブジェクトを初期化する必要があります。

マネージド ID 承認の場合は、次の変数を作成します。

sourceUri。翻訳するドキュメントが含まれるソースコンテナーの URI。
targetUri。翻訳されたドキュメントが書き込まれるターゲットコンテナーの URL。

targetLanguageCode。翻訳されるドキュメントの言語コード。言語コードは、言語サポートに関するページに記載されています。

ソース URL とターゲット URL を見つけるには、Azure portal のストレージアカウントに移動します。左側のサイドバーの [データストレージ] で [コンテナー] を選び、以下の手順に従ってソースドキュメントとターゲットコンテナー URLS を取得します。

source	移行先
1. ソースコンテナーの横にあるチェックボックスをオンにします。	1. ターゲットコンテナーの横にあるチェックボックスをオンにします。
2.メインウィンドウ領域から、翻訳するファイルまたはドキュメントを選びます。	2. 右側にある省略記号を選択し、[プロパティ] を選択します。
3. ソース URL は、[プロパティ] リストの上部にあります。	3. ターゲット URL は、[プロパティ] リストの上部にあります。

Shared Access Signature (SAS) 承認の場合、これらの変数を作成します
- sourceUri。変換するドキュメントを含むソースコンテナーの SAS トークンがクエリ文字列として追加された SAS URI。
- targetUri 翻訳されたドキュメントの書き込み先のターゲットコンテナーに対応する SAS トークンがクエリ文字列として追加された SAS URI。
- targetLanguageCode。翻訳されるドキュメントの言語コード。言語コードは、言語サポートに関するページに記載されています。

重要

終わったらコードからキーを削除し、公開しないよう注意してください。運用環境では、Azure Key Vault などの資格情報を格納してアクセスする安全な方法を使用します。詳しくは、「Azure AI サービスのセキュリティ」をご覧ください。

非同期翻訳のコードサンプル

次のコードサンプルを入力して、アプリケーションの Program.cs ファイルに貼り付けます。


using Azure;
using Azure.AI.Translation.Document;
using System;
using System.Threading;
using System.Text;

class Program {

  // create variables for your custom endpoint and resource key
  private static readonly string endpoint = "<your-document-translation-endpoint>";
  private static readonly string key = "<your-key>";

  static async Task Main(string[] args) {

    // create variables for your sourceUrl, targetUrl, and targetLanguageCode
    Uri sourceUri = new Uri("<sourceUrl>");
    Uri targetUri = new Uri("<targetUrl>");
    string targetLanguage = "<targetLanguageCode>"

    // initialize a new instance  of the DocumentTranslationClient object to interact with the Document translation feature
    DocumentTranslationClient client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(key));

    // initialize a new instance of the `DocumentTranslationInput` object to provide the ___location of input for the translation operation
    DocumentTranslationInput input = new DocumentTranslationInput(sourceUri, targetUri, targetLanguage);

    // initialize a new instance of the DocumentTranslationOperation class to track the status of the translation operation
    DocumentTranslationOperation operation = await client.StartTranslationAsync(input);

    await operation.WaitForCompletionAsync();

    Console.WriteLine($"  Status: {operation.Status}");
    Console.WriteLine($"  Created on: {operation.CreatedOn}");
    Console.WriteLine($"  Last modified: {operation.LastModified}");
    Console.WriteLine($"  Total documents: {operation.DocumentsTotal}");
    Console.WriteLine($"    Succeeded: {operation.DocumentsSucceeded}");
    Console.WriteLine($"    Failed: {operation.DocumentsFailed}");
    Console.WriteLine($"    In Progress: {operation.DocumentsInProgress}");
    Console.WriteLine($"    Not started: {operation.DocumentsNotStarted}");

    await foreach(DocumentStatusResult document in operation.Value) {
      Console.WriteLine($"Document with Id: {document.Id}");
      Console.WriteLine($"  Status:{document.Status}");
      if (document.Status == DocumentTranslationStatus.Succeeded) {
        Console.WriteLine($"  Translated Document Uri: {document.TranslatedDocumentUri}");
        Console.WriteLine($"  Translated to language: {document.TranslatedToLanguageCode}.");
        Console.WriteLine($"  Document source Uri: {document.SourceDocumentUri}");
      } else {
        Console.WriteLine($"  Error Code: {document.Error.Code}");
        Console.WriteLine($"  Message: {document.Error.Message}");
      }
    }
  }
}

アプリケーションを実行する

コードサンプルをアプリケーションに追加したら、ターミナルで次のコマンドを入力して、プロジェクトディレクトリからアプリケーションを実行します。

  dotnet run

予想される出力のスニペットを次に示します。

ターミナルウィンドウでの Visual Studio Code 出力のスクリーンショット。

同期翻訳のコードサンプル

このクイックスタートでは、ドキュメント翻訳のサンプルドキュメントをダウンロードできます。ソース言語は英語です。



using Azure;
using Azure.AI.Translation.Document;
using System;
using System.Threading;
using System.Text;

class Program {

  string endpoint = "{your-document-translation-endpoint}";
  string apiKey = "{your-api-key}";
  SingleDocumentTranslationClient client = new SingleDocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));

  try
  {
    string filePath = @"C:\{folder}\document.txt"
    using Stream fileStream = File.OpenRead(filePath);

    // MultipartFormFileData (string name, System.IO.Stream content, string contentType);
    var sourceDocument = new MultipartFormFileData(Path.GetFileName(filePath), fileStream, "application/vnd.openxmlformats-officedocument.wordprocessingml.document");

    DocumentTranslateContent content = new DocumentTranslateContent(sourceDocument);

    // DocumentTranslate (string targetLanguage, Azure.AI.Translation.Document.DocumentTranslateContent documentTranslateContent, string sourceLanguage = default, string category = default, bool? allowFallback = default, System.Threading.CancellationToken cancellationToken = default);
    var response = client.DocumentTranslate("de", content);

    Console.WriteLine($"Request string for translation: {requestString}");
    Console.WriteLine($"Response string after translation: {responseString}");
  }
    catch (RequestFailedException exception) {
    Console.WriteLine($"Error Code: {exception.ErrorCode}");
    Console.WriteLine($"Message: {exception.Message}");
  }
}

C#/.NET 環境を設定する

このクイックスタートでは、最新バージョンの Visual Studio IDE を使用して、アプリケーションをビルドして実行します。

Visual Studio を起動します。
[概要] ページで、[新しいプロジェクトの作成] を選択します。
[新しいプロジェクトの作成] ページで、検索ボックスに「コンソール」と入力します。 [コンソールアプリケーション] テンプレートを選択し、 [次へ] を選択します。
[新しいプロジェクトの構成] ダイアログウィンドウの [プロジェクト名] ボックスに「asynchronous-sdk」と入力します。 [次へ] を選びます。
[追加情報] ダイアログウィンドウで、[.NET 6.0 (長期的なサポート)] を選択し、[作成] を選択します。

NuGet を使用してクライアントライブラリをインストールする

Translator-text-sdk プロジェクトを右クリックし、[NuGet パッケージの管理...] を選択します。
[参照] タブを選択し、「Azure.AI.Translation.Document」と入力します。
プロジェクトでパッケージを選択してインストールします。

C# アプリケーションをビルドする

注意

.NET 6 以降では、console テンプレートを使用する新しいプロジェクトによって、以前のバージョンとは異なる新しいプログラムスタイルが生成されます。
この新しい出力では、記述する必要があるコードを簡素化できる最新の C# 機能が使用されています。
新しいバージョンで使用する場合、記述する必要があるのは、`Main` メソッドの本体のみです。最上位レベルのステートメント、グローバル using ディレクティブ、または暗黙的な using ディレクティブを含める必要はありません。
詳細については、「C# コンソールアプリテンプレートで最上位レベルのステートメントが生成される」を "参照してください"。

Program.cs ファイルを開きます。
行 Console.WriteLine("Hello World!")を含め、既存のコードを削除します。
アプリケーションの Program.cs で、対象のキーとカスタムエンドポイントの変数を作成します。詳細については、「キーとカスタムドメインエンドポイントを取得する」をご覧ください。

private static readonly string endpoint = "<your-document-translation-endpoint>";
private static readonly string key = "<your-key>";

1 つの BLOB コンテナー内の 1 つ以上のドキュメントについて翻訳操作を開始するには、StartTranslationAsync メソッドを呼び出します。

StartTranslationAsync を呼び出すには、以下の DocumentTranslationInput、sourceUri パラメーターを含む targetUri オブジェクトを初期化する必要があります。

マネージド ID 承認の場合は、次の変数を作成します。

sourceUri。翻訳するドキュメントが含まれるソースコンテナーの URI。
targetUri。翻訳されたドキュメントが書き込まれるターゲットコンテナーの URL。

targetLanguageCode。翻訳されるドキュメントの言語コード。言語コードは、言語サポートに関するページに記載されています。

source	移行先
1. ソースコンテナーの横にあるチェックボックスをオンにします。	1. ターゲットコンテナーの横にあるチェックボックスをオンにします。
2.メインウィンドウ領域から、翻訳するファイルまたはドキュメントを選びます。	2. 右側にある省略記号を選択し、[プロパティ] を選択します。
3. ソース URL は、[プロパティ] リストの上部にあります。	3. ターゲット URL は、[プロパティ] リストの上部にあります。

Shared Access Signature (SAS) 承認の場合、これらの変数を作成します
- sourceUri。変換するドキュメントを含むソースコンテナーの SAS トークンがクエリ文字列として追加された SAS URI。
- targetUri 翻訳されたドキュメントの書き込み先のターゲットコンテナーに対応する SAS トークンがクエリ文字列として追加された SAS URI。
- targetLanguageCode。翻訳されるドキュメントの言語コード。言語コードは、言語サポートに関するページに記載されています。

非同期翻訳のコードサンプル

重要

次のコードサンプルを入力して、アプリケーションの Program.cs ファイルに貼り付けます。


using Azure;
using Azure.AI.Translation.Document;

class Program {

  // create variables for your custom endpoint and resource key
  private static readonly string endpoint = "<your-document-translation-endpoint>";
  private static readonly string key = "<your-key>";

  static async Task Main(string[] args) {

    // create variables for your sourceUrl, targetUrl, and targetLanguageCode
    Uri sourceUri = new Uri("<sourceUrl>");
    Uri targetUri = new Uri("<targetUrl>");
    string targetLanguage = "<targetLanguageCode>";

    // initialize a new instance  of the DocumentTranslationClient object to interact with the Document translation feature
    DocumentTranslationClient client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(key));

    // initialize a new instance of the `DocumentTranslationInput` object to provide source and target locations and target language for the translation operation
    DocumentTranslationInput input = new DocumentTranslationInput(sourceUri, targetUri, targetLanguage);

    // initialize a new instance of the DocumentTranslationOperation class to track the status of the translation operation
    DocumentTranslationOperation operation = await client.StartTranslationAsync(input);

    await operation.WaitForCompletionAsync();

    Console.WriteLine($"  Status: {operation.Status}");
    Console.WriteLine($"  Created on: {operation.CreatedOn}");
    Console.WriteLine($"  Last modified: {operation.LastModified}");
    Console.WriteLine($"  Total documents: {operation.DocumentsTotal}");
    Console.WriteLine($"    Succeeded: {operation.DocumentsSucceeded}");
    Console.WriteLine($"    Failed: {operation.DocumentsFailed}");
    Console.WriteLine($"    In Progress: {operation.DocumentsInProgress}");
    Console.WriteLine($"    Not started: {operation.DocumentsNotStarted}");

    await foreach(DocumentStatusResult document in operation.Value) {
      Console.WriteLine($"Document with Id: {document.Id}");
      Console.WriteLine($"  Status:{document.Status}");
      if (document.Status == DocumentTranslationStatus.Succeeded) {
        Console.WriteLine($"  Translated Document Uri: {document.TranslatedDocumentUri}");
        Console.WriteLine($"  Translated to language: {document.TranslatedToLanguageCode}.");
        Console.WriteLine($"  Document source Uri: {document.SourceDocumentUri}");
      } else {
        Console.WriteLine($"  Error Code: {document.Error.Code}");
        Console.WriteLine($"  Message: {document.Error.Message}");
      }
    }
  }
}

アプリケーションを実行する

アプリケーションにコードサンプルを追加したら、formRecognizer_quickstart の横にある緑色の [スタート] ボタンを選んで、プログラムをビルドして実行するか、F5 キーを押します。

スクリーンショット: Visual Studioプログラムの実行。

予想される出力のスニペットを次に示します。

ターミナルウィンドウでの Visual Studio Code 出力のスクリーンショット。

同期翻訳のコードサンプル

このクイックスタートでは、ドキュメント翻訳のサンプルドキュメントをダウンロードできます。ソース言語は英語です。



using Azure;
using Azure.AI.Translation.Document;
using System;
using System.Threading;
using System.Text;

class Program {

  string endpoint = "{your-document-translation-endpoint}";
  string apiKey = "{your-api-key}";
  SingleDocumentTranslationClient client = new SingleDocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));

  try
  {
    string filePath = @"C:\{folder}\document-translation-sample.docx"
    using Stream fileStream = File.OpenRead(filePath);

    // MultipartFormFileData (string name, System.IO.Stream content, string contentType);
    var sourceDocument = new MultipartFormFileData(Path.GetFileName(filePath), fileStream, "application/vnd.openxmlformats-officedocument.wordprocessingml.document");

    DocumentTranslateContent content = new DocumentTranslateContent(sourceDocument);

    // DocumentTranslate (string targetLanguage, Azure.AI.Translation.Document.DocumentTranslateContent documentTranslateContent, string sourceLanguage = default, string category = default, bool? allowFallback = default, System.Threading.CancellationToken cancellationToken = default);
    var response = client.DocumentTranslate("de", content);

    Console.WriteLine($"Request string for translation: {requestString}");
    Console.WriteLine($"Response string after translation: {responseString}");
  }
    catch (RequestFailedException exception) {
    Console.WriteLine($"Error Code: {exception.ErrorCode}");
    Console.WriteLine($"Message: {exception.Message}");
  }
}

これで完了です。 .NET クライアントライブラリを使ってストレージコンテナー内のドキュメントを翻訳するプログラムを作成しました。

プロジェクトの設定

最新バージョンの Python がインストールされていることを確認します。

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

ドキュメント翻訳クライアントライブラリの最新バージョンをインストールします。

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

バッチファイルを翻訳する

このプロジェクトでは、ソースコンテナーにアップロードされたソースドキュメントが必要です。このクイックスタートでは、ドキュメント翻訳のサンプルドキュメントをダウンロードできます。ソース言語は英語です。
Python アプリケーションファイルで、リソースキーとカスタムエンドポイントの変数を作成します。詳細については、「キーとカスタムドメインエンドポイントを取得する」をご覧ください。

key = "{your-api-key}"
endpoint = "{your-document-translation-endpoint}"

DocumentTranslationClient パラメーターと endpoint パラメーターを含む key オブジェクトを初期化します。

begin_translation メソッドを呼び出し、sourceUri、targetUri、targetLanguageCode パラメーターを渡します。

マネージド ID 承認の場合は、次の変数を作成します。

sourceUri。翻訳するドキュメントが含まれるソースコンテナーの URI。
targetUri。翻訳されたドキュメントが書き込まれるターゲットコンテナーの URL。

targetLanguageCode。翻訳されるドキュメントの言語コード。言語コードは、言語サポートに関するページに記載されています。

source	移行先
1. ソースコンテナーの横にあるチェックボックスをオンにします。	1. ターゲットコンテナーの横にあるチェックボックスをオンにします。
2.メインウィンドウ領域から、翻訳するファイルまたはドキュメントを選びます。	2. 右側にある省略記号を選択し、[プロパティ] を選択します。
3. ソース URL は、[プロパティ] リストの上部にあります。	3. ターゲット URL は、[プロパティ] リストの上部にあります。

Shared Access Signature (SAS) 承認の場合、これらの変数を作成します
- sourceUri。変換するドキュメントを含むソースコンテナーの SAS トークンがクエリ文字列として追加された SAS URI。
- targetUri 翻訳されたドキュメントの書き込み先のターゲットコンテナーに対応する SAS トークンがクエリ文字列として追加された SAS URI。
- targetLanguageCode。翻訳されるドキュメントの言語コード。言語コードは、言語サポートに関するページに記載されています。

非同期翻訳のコードサンプル

重要

Python アプリケーションに次のコードサンプルを入力します。


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

# create variables for your resource key, custom endpoint, sourceUrl, targetUrl, and targetLanguage
key = '{your-api-key}'
endpoint = '{your-document-translation-endpoint}'
sourceUri = '<your-container-sourceUrl>'
targetUri = '<your-container-targetUrl>'
targetLanguage = '<target-language-code>'


# initialize a new instance of the DocumentTranslationClient object to interact with the asynchronous Document translation feature
client = DocumentTranslationClient(endpoint, AzureKeyCredential(key))

# include source and target locations and target language code for the begin translation operation
poller = client.begin_translation(sourceUri, targetUri, targetLanguage)
result = poller.result()

print('Status: {}'.format(poller.status()))
print('Created on: {}'.format(poller.details.created_on))
print('Last updated on: {}'.format(poller.details.last_updated_on))
print(
    'Total number of translations on documents: {}'.format(
        poller.details.documents_total_count
    )
)

print('\nOf total documents...')
print('{} failed'.format(poller.details.documents_failed_count))
print('{} succeeded'.format(poller.details.documents_succeeded_count))

for document in result:
    print('Document ID: {}'.format(document.id))
    print('Document status: {}'.format(document.status))
    if document.status == 'Succeeded':
        print('Source document ___location: {}'.format(document.source_document_url))
        print(
            'Translated document ___location: {}'.format(document.translated_document_url)
        )
        print('Translated to language: {}\n'.format(document.translated_to))
    else:
        print(
            'Error Code: {}, Message: {}\n'.format(
                document.error.code, document.error.message
            )
        )

アプリケーションを実行する

アプリケーションにコードサンプルを追加したら、ターミナルで次のコマンドを入力します。

python asynchronous-sdk.py

予想される出力のスニペットを次に示します。

ターミナルウィンドウの Python 出力のスクリーンショット。

同期翻訳のコードサンプル

このクイックスタートでは、ドキュメント翻訳のサンプルドキュメントをダウンロードできます。ソース言語は英語です。

import os
from azure.core.credentials import AzureKeyCredential
from azure.ai.translation.document import SingleDocumentTranslationClient
from azure.ai.translation.document.models import DocumentTranslateContent


def sample_single_document_translation():

    # create variables for your resource api key, document translation endpoint, and target language
    key = "<your-api-key>"
    endpoint = "<your-document-translation-endpoint>"
    target_language = "{target-language-code}"

    # initialize a new instance of the SingleDocumentTranslationClient object to interact with the synchronous Document translation feature
    client = SingleDocumentTranslationClient(endpoint, AzureKeyCredential(key))

    # absolute path to your document
    file_path = "C:/{your-file-path}/document-translation-sample.docx"
    file_name = os.path.basename(file_path)
    file_type = (
        "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
    )
    print(f"File for translation: {file_name}")

    with open(file_path, "rb") as file:
        file_contents = file.read()

    document_content = (file_name, file_contents, file_type)
    document_translate_content = DocumentTranslateContent(document=document_content)

    response_stream = client.document_translate(
        body=document_translate_content, target_language=target_language
    )
    # Save the response_stream to a file
    output_file_path = "./translated-document.docx"
    with open(output_file_path, "wb") as output_file:
        output_file.write(response_stream)
    
    print(f"Translated document saved to: {output_file_path}")


if __name__ == "__main__":
    sample_single_document_translation()

これで完了です。 Python クライアントライブラリを使用して、ドキュメントを非同期的および同期的に翻訳するプログラムを作成しました。

次のステップ

ドキュメント翻訳操作の詳細

次の方法で共有

作業の開始: ドキュメント翻訳クライアント ライブラリ

前提条件

ストレージ コンテナーの承認

アプリケーションをビルドする

プロジェクトの設定

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

ドキュメントを非同期で翻訳する

非同期翻訳のコード サンプル

アプリケーションを実行する

同期翻訳のコード サンプル

プロジェクトの設定

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

バッチ ファイルを翻訳する

非同期翻訳のコード サンプル

アプリケーションを実行する

同期翻訳のコード サンプル

次のステップ

フィードバック

その他のリソース

作業の開始: ドキュメント翻訳クライアントライブラリ

ストレージコンテナーの承認

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

非同期翻訳のコードサンプル

同期翻訳のコードサンプル

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

バッチファイルを翻訳する

非同期翻訳のコードサンプル

同期翻訳のコードサンプル