ドキュメント翻訳を使ってみる

[アーティクル]
01/17/2024

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

前提条件

重要

現在、Java および JavaScript ドキュメント翻訳 SDK はパブリックプレビューで利用できます。機能、アプローチ、およびプロセスは、一般提供 (GA) リリースの前に、ユーザーからのフィードバックに基づいて変更される可能性があります。
C# と Python SDK は、運用アプリケーションで使用できる一般提供 (GA) リリースです
ドキュメント翻訳は現在、Translator (単一サービス) リソースでのみサポートされており、Azure AI サービス (マルチサービス) リソースには含まれていません。
ドキュメント翻訳は、S1 Standard サービスプラン (従量課金制) または D3 ボリューム割引プランのみでサポートされています。「Azure AI サービスの価格 - Translator」をご覧ください。

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

アクティブな Azure アカウント。アカウントがない場合は、無料アカウントを作成できます。
Azure Blob Storage アカウント。 Azure Blob Storage アカウント内に、ソースとターゲットの各ファイル用のコンテナーを作成する必要があります。
- ソースのコンテナー。このコンテナーは、翻訳対象のファイルをアップロードする場所です (必須)。
- ターゲットのコンテナー。このコンテナーは、翻訳されたファイルを格納する場所です (必須)。
単一サービス Translator リソース (マルチサービス Azure AI サービスリソースとは異なる):

次のように、Translator プロジェクトとインスタンスの詳細フィールドを入力します。
1. [サブスクリプション]。使用できる Azure サブスクリプションのいずれかを選択します。
2. [リソースグループ]。新しいリソースグループを作成するか、同じライフサイクル、アクセス許可、ポリシーを共有する既存のリソースグループにリソースを追加することができます。
3. [リソースリージョン] . ご自身のビジネスまたはアプリケーションが特定のリージョンを必要としない限り、 [グローバル] を選択します。認証にシステム割り当てマネージド ID を使用する場合は、米国西部などの地理的リージョンを選択します。
4. 名前。リソースに選んだ名前を入力します。選択した名前は Azure 内で一意である必要があります。
  
  Note
  
  ドキュメント翻訳には、カスタムドメインエンドポイントが必要です。名前フィールドに入力する値は、エンドポイントのカスタムドメイン名となります。
5. 価格レベル。ドキュメント翻訳は、Free レベルではサポートされません。 このサービスを試すには、Standard S1 を選択してください。
6. [確認および作成] を選択します。
7. サービス条件を確認し、 [作成] を選択してリソースをデプロイします。
8. リソースが正常にデプロイされたら、[リソースに移動] を選びます。

キーとドキュメント翻訳エンドポイントを取得する

* Translator サービスへの要求では、アクセスを認証するために読み取り専用キーとカスタムエンドポイントが必要です。カスタムドメインエンドポイントは、リソース名、ホスト名、Translator サブディレクトリを指定した形式の URL であり、Azure portal で使用できます。

新しいリソースを作成した場合は、そのデプロイ後に [リソースに移動] を選びます。既存のドキュメント翻訳リソースがある場合は、リソースページに直接移動します。
左側のレールの [リソース管理] で、 [キーとエンドポイント] を選択します。
ドキュメント翻訳サービスで要求を認証するため、key と document translation endpoint をコピーし、コードサンプルに貼り付けることができます。 API 呼び出しを行うために必要なキーは 1 つだけです。

Azure Blob Storage コンテナーを作成する

Azure Blob Storage アカウント内に、ソースおよびターゲットの各ファイル用のコンテナーを作成する必要があります。

ソースのコンテナー。このコンテナーは、翻訳対象のファイルをアップロードする場所です (必須)。
ターゲットのコンテナー。このコンテナーは、翻訳されたファイルを格納する場所です (必須)。

必要な認証

sourceUrl、targetUrl、省略可能な glossaryUrl には Shared Access Signature (SAS) トークンを含める必要があり、クエリ文字列として追加します。トークンは、コンテナーまたは特定の BLOB に割り当てることができます。「ドキュメント翻訳プロセスの SAS トークンを作成する」を "参照してください"。

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

ヒント

操作で複数のファイル (BLOB) を翻訳する場合は、コンテナーレベルで SAS アクセス権を委任します。
操作で 1 つ のファイル (BLOB) を翻訳する場合は、BLOB レベルで SAS アクセス権を委任します。
SAS トークンの代わりに、システム割り当てマネージド ID を認証に使用することができます。

サンプルドキュメント

このプロジェクトでは、ソースコンテナーにアップロードされたソースドキュメントが必要です。このクイックスタートでは、ドキュメント翻訳のサンプルドキュメントをダウンロードできます。ソース言語は英語です。

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

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

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

Newtonsoft.Json のインストール

document-translation-qs プロジェクトを右クリックし、[NuGet パッケージの管理...] を選択します。
[参照] タブを選択し、「NewtonsoftJson」と入力します。
ドロップダウンメニューから最新の安定バージョンを選択し、プロジェクトにパッケージをインストールします。

ストレージコンテナー内のすべてのドキュメントを翻訳する

注意

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

Program.cs ファイルを開きます。
行 Console.WriteLine("Hello World!") を含む既存のコードを削除します。
ドキュメント翻訳のコードサンプルをコピーして、Program.cs ファイルに貼り付けます。
- {your-document-translation-endpoint} と {your-key} を、Azure portal Translator インスタンスの値で更新します。
- {your-source-container-SAS-URL} と {your-target-container-SAS-URL} を、Azure portal のストレージアカウントコンテナーインスタンスの値で更新します。

コードサンプル

重要

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

using System.Text;

class Program
{
    private static readonly string endpoint = "{your-document-translator-endpoint}/translator/text/batch/v1.1";

    private static readonly string key = "{your-key}";

    static readonly string route = "/batches";
    static readonly string sourceURL = "\" {your-source-container-SAS-URL}\"";
    static readonly string targetURL = " \"{your-target-container-SAS-URL}\"";


    static readonly string json = ("{\"inputs\": [{\"source\": {\"sourceUrl\":"+sourceURL+" ,\"storageSource\": \"AzureBlob\",\"language\": \"en\"}, \"targets\": [{\"targetUrl\":"+targetURL+",\"storageSource\": \"AzureBlob\",\"category\": \"general\",\"language\": \"es\"}]}]}");

    static async Task Main(string[] args)
    {
        using HttpClient client = new HttpClient();
        using HttpRequestMessage request = new HttpRequestMessage();
        {

            StringContent content = new StringContent(json, Encoding.UTF8, "application/json");

            request.Method = HttpMethod.Post;
            request.RequestUri = new Uri(endpoint + route);
            request.Headers.Add("Ocp-Apim-Subscription-Key", key);
            request.Content = content;

            HttpResponseMessage response = await client.SendAsync(request);
            string result = response.Content.ReadAsStringAsync().Result;
            if (response.IsSuccessStatusCode)
            {
                Console.WriteLine($"Status code: {response.StatusCode}");
                Console.WriteLine();
                Console.WriteLine($"Response Headers:");
                Console.WriteLine(response.Headers);
            }
            else
                Console.Write("Error");

        }

    }

}

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

アプリケーションにコードサンプルを追加したら、document-translation-qs の横にある緑色の開始ボタンを選択してプログラムをビルドして実行するか、または F5 キーを押します。

Screenshot: run your Visual Studio program.

正常に完了したら、次のようになります。

翻訳されたドキュメントはターゲットコンテナーにあります。
成功した POST メソッドから 202 Accepted 応答コードが返され、バッチ要求によってサービスが作成されたことが示されます。
POST 要求では、後続の GET 要求で使用される値を提供する Operation-Location を含む応答ヘッダーも返します。

Go 環境を設定する

Go アプリケーションは、テキストエディターを使用して記述することができます。最新バージョンの Visual Studio Code と Go 拡張機能を使用することをお勧めします。

ヒント

Go を初めて使う場合は、「Go の使用を開始する」Learn モジュールを試してください。

まだの場合は、Go をダウンロードしてインストールしてください。

お使いのオペレーティングシステムに対応した Go バージョンをダウンロードしてください。
ダウンロードが完了したら、インストーラーを実行します。
コマンドプロンプトを開き、次のように入力して Go がインストールされたことを確認します。
```
go version
```

ストレージコンテナー内のすべてのドキュメントを翻訳する

コンソールウィンドウ (cmd、PowerShell、Bash など) で、アプリ用の新しいディレクトリを document-translation-qs という名前で作成し、そこに移動します。
document-translation-qs ディレクトリに document-translation.go という名前の新しい Go ファイルを作成します。
ドキュメント翻訳のコードサンプルをコピーして、document-translation.go ファイルに貼り付けます。
- {your-document-translation-endpoint} と {your-key} を、Azure portal Translator インスタンスの値で更新します。
- {your-source-container-SAS-URL} と {your-target-container-SAS-URL} を、Azure portal のストレージアカウントコンテナーインスタンスの値で更新します。

コードサンプル

重要

package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "net/http"
)

func main() {

    httpposturl := "{your-document-translation-endpoint}/translator/text/batch/v1.1/batches"
    fmt.Println("Response", httpposturl)

    var jsonData = []byte(`{
        "inputs": [
            {
                "source": {
                    "sourceUrl": "{your-source-container-SAS-URL}"
                },
                "targets": [
                    {
                        "{your-target-container-SAS-URL}",
                        "language": "fr"
                    }
                ]
            }
        ]
    }`)

    request, error := http.NewRequest("POST", httpposturl, bytes.NewBuffer(jsonData))
    request.Header.Set("Content-Type", "application/json")
    request.Header.Set("Ocp-Apim-Subscription-Key", "{your-key}")

    client := &http.Client{}
    response, error := client.Do(request)
    if error != nil {
        panic(error)
    }
    defer response.Body.Close()

    fmt.Println("response Status:", response.Status)
    var printHeader = (response.Header)
    prettyJSON, _ := json.MarshalIndent(printHeader, "", "  ")
    fmt.Printf("%s\n", prettyJSON)
}

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

アプリケーションにコードサンプルを追加したら、Go プログラムをコマンドまたはターミナルプロンプトで実行できます。プロンプトのパスが document-translation-qs フォルダーに設定されていることを確認し、次のコマンドを使用します。

go run document-translation.go

正常に完了したら、次のようになります。

翻訳されたドキュメントはターゲットコンテナーにあります。
成功した POST メソッドから 202 Accepted 応答コードが返され、バッチ要求によってサービスが作成されたことが示されます。
POST 要求では、後続の GET 要求で使用される値を提供する Operation-Location を含む応答ヘッダーも返します。

文書の翻訳に成功しました。問題が発生しました。

Java 環境を設定する

このクイックスタートでは、Gradle ビルド自動化ツールを使用して、アプリケーションを作成して実行します。

Visual Studio Code または任意の IDE の最新バージョンが必要です。 Java in Visual Studio Code をご覧ください。
ヒント
- Visual Studio Code には、Windows および macOS 用の Java 用コーディングパック が用意されています。コーディングパックは、VS Code、Java Development Kit (JDK)、および Microsoft が推奨する拡張機能のコレクションのバンドルです。コーディングパックを使用して、既存の開発環境を修正できます。
- VS Code と Java 用のコーディングパックを使用している場合は、Java 用 Gradle 拡張機能をインストールします。
Visual Studio Code を使用していない場合、開発環境に次のものがインストールされていることを確認してください。
- Java Development Kit (OpenJDK) バージョン 8 以降。
- Gradle、バージョン 6.8 以降。

新しい Gradle プロジェクトを作成する

コンソールウィンドウ (cmd、PowerShell、Bash など) で、アプリ用の新しいディレクトリを document-translation という名前で作成し、そこに移動します。
```
mkdir document-translation && document-translation
```
```
mkdir document-translation; cd document-translation
```
document-translation ディレクトリから gradle init コマンドを実行します。このコマンドによって、Gradle 用の重要なビルドファイルが作成されます。たとえば、実行時にアプリケーションを作成して構成するために使用される build.gradle.kts などです。
```
gradle init --type basic
```
DSL を選択するよう求められたら、Kotlin を選択します。
Return または Enter キーを選択して、既定のプロジェクト名 (document-translation) を受け入れます。

注意

アプリケーション全体が作成されるまで数分かかる場合がありますが、build-gradle.kts を含むいくつかのフォルダーとファイルがすぐに表示されます。
次のコードを使用して build.gradle.kts を更新します。

plugins {
  java
  application
}
application {
  mainClass.set("DocumentTranslation")
}
repositories {
  mavenCentral()
}
dependencies {
  implementation("com.squareup.okhttp3:okhttp:4.10.0")
  implementation("com.google.code.gson:gson:2.9.0")
}

ストレージコンテナー内のすべてのドキュメントを翻訳する

document-translation ディレクトリから、次のコマンドを実行します。
```
mkdir -p src/main/java
```
このコマンドにより、次のディレクトリ構造が作成されます。
java ディレクトリに移動して、DocumentTranslation.java という名前のファイルを作成します。
ヒント
- PowerShell を使用して新しいファイルを作成できます。
- Shift キーを押しながらフォルダーを右クリックして、プロジェクトディレクトリで PowerShell ウィンドウを開きます。
- New-Item DocumentTranslation.java コマンドを入力します。
- IDE で、DocumentTranslation.java という名前の新しいファイルを作成し、それを java ディレクトリに保存することもできます。
ドキュメント翻訳のコードサンプルをコピーして、DocumentTranslation.java ファイルに貼り付けます。
- {your-document-translation-endpoint} と {your-key} を、Azure portal Translator インスタンスの値で更新します。
- {your-source-container-SAS-URL} と {your-target-container-SAS-URL} を、Azure portal のストレージアカウントコンテナーインスタンスの値で更新します。

コードサンプル

重要

import java.io.*;
import java.net.*;
import java.util.*;
import okhttp3.*;

public class DocumentTranslation {
    String key = "{your-key}";

    String endpoint = "{your-document-translation-endpoint}/translator/text/batch/v1.1";

    String path = endpoint + "/batches";

    String sourceSASUrl = "{your-source-container-SAS-URL}";

    String targetSASUrl = "{your-target-container-SAS-URL}";

    String jsonInputString = (String.format("{\"inputs\":[{\"source\":{\"sourceUrl\":\"%s\"},\"targets\":[{\"targetUrl\":\"%s\",\"language\":\"fr\"}]}]}", sourceSASUrl, targetSASUrl));

    OkHttpClient client = new OkHttpClient();

    public void post() throws IOException {
        MediaType mediaType = MediaType.parse("application/json");
        RequestBody body = RequestBody.create(mediaType,  jsonInputString);
        Request request = new Request.Builder()
                .url(path).post(body)
                .addHeader("Ocp-Apim-Subscription-Key", key)
                .addHeader("Content-type", "application/json")
                .build();
        Response response = client.newCall(request).execute();
        System.out.println(response.code());
        System.out.println(response.headers());
    }

  public static void main(String[] args) {
        try {
            DocumentTranslation sampleRequest = new DocumentTranslation();
            sampleRequest.post();
        } catch (Exception e) {
            System.out.println(e);
        }
    }
}

Java アプリケーションをビルドして実行する

アプリケーションにコードサンプルを追加したら、メインプロジェクトディレクトリ (document-translation) に戻り、コンソールウィンドウを開き、次のコマンドを入力します。
1. build コマンドを使用してアプリケーションをビルドします。
```
gradle build
```
2. run コマンドを使用してアプリケーションを実行します。
```
gradle run
```

正常に完了したら、次のようになります。

翻訳されたドキュメントはターゲットコンテナーにあります。
成功した POST メソッドから 202 Accepted 応答コードが返され、バッチ要求によってサービスが作成されたことが示されます。
POST 要求では、後続の GET 要求で使用される値を提供する Operation-Location を含む応答ヘッダーも返します。

文書の翻訳に成功しました。問題が発生しました。

Node.js 環境を設定する

このクイックスタートでは、Node.js JavaScript ランタイム環境を使用して、アプリケーションを作成して実行します。

最新バージョンの Node.js をまだインストールしていない場合はインストールします。 Node.js のインストールには、ノードパッケージマネージャー (npm) が含まれます。

ヒント

Node.js を初めて使う場合は、「Node.js の概要」Learn モジュールを試してください。
コンソールウィンドウ (cmd、PowerShell、Bash など) で、アプリ用の新しいディレクトリを document-translation という名前で作成し、そこに移動します。
```
mkdir document-translation && cd document-translation
```
```
mkdir document-translation; cd document-translation
```
npm init コマンドを実行して、アプリケーションを初期化し、プロジェクトをスキャフォールディングします。
```
npm init
```
ターミナルに表示されるプロンプトを受け入れて、プロジェクトの属性を指定します。
- 最も重要な属性は、名前、バージョン番号、およびエントリポイントです。
- エントリポイント名は index.js を保持することをお勧めします。説明、テストコマンド、GitHub リポジトリ、キーワード、作成者、ライセンス情報はオプションの属性であり、このプロジェクトでは省略可能です。
- [戻る] または Enter キーを押して、かっこで囲んだ候補を受け入れます。
- 画面の指示に従って入力すると、document-translation ディレクトリに package.json ファイルが作成されます。
npm を使用して、ドキュメント翻訳アプリディレクトリに axios HTTP ライブラリと uuid パッケージをインストールします。
```
npm install axios uuid
```

ストレージコンテナー内のすべてのドキュメントを翻訳する

アプリディレクトリの index.js ファイルを作成します。
ヒント
- PowerShell を使用して新しいファイルを作成できます。
- Shift キーを押しながらフォルダーを右クリックして、プロジェクトディレクトリで PowerShell ウィンドウを開きます。
- 次のコマンド New-Item index.js を入力します。
- IDE で、index.js という名前の新しいファイルを作成し、それを document-translation ディレクトリに保存することもできます。
ドキュメント翻訳のコードサンプルをコピーして、index.js ファイルに貼り付けます。
- {your-document-translation-endpoint} と {your-key} を、Azure portal Translator インスタンスの値で更新します。
- {your-source-container-SAS-URL} と {your-target-container-SAS-URL} を、Azure portal のストレージアカウントコンテナーインスタンスの値で更新します。

コードサンプル

重要

const axios = require('axios').default;

let endpoint = '{your-document-translation-endpoint}/translator/text/batch/v1.1';
let route = '/batches';
let key = '{your-key}';
let sourceSASUrl = "{your-source-container-SAS-URL}";
let targetSASUrl = "{your-target-container-SAS-URL}"

let data = JSON.stringify({"inputs": [
  {
      "source": {
          "sourceUrl": sourceSASUrl,
          "storageSource": "AzureBlob",
          "language": "en"
      },
      "targets": [
          {
              "targetUrl": targetSASUrl,
              "storageSource": "AzureBlob",
              "category": "general",
              "language": "es"}]}]});

let config = {
  method: 'post',
  baseURL: endpoint,
  url: route,
  headers: {
    'Ocp-Apim-Subscription-Key': key,
    'Content-Type': 'application/json'
  },
  data: data
};

axios(config)
.then(function (response) {
  let result = { statusText: response.statusText, statusCode: response.status, headers: response.headers };
  console.log()
  console.log(JSON.stringify(result, null, 2));
})
.catch(function (error) {
  console.log(error);
});

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

アプリケーションにコードサンプルを追加したら、プログラムを実行します。

アプリケーションディレクトリ (document-translation) に移動します。
ご利用のターミナルで、次のコマンドを入力して実行します。
```
node index.js
```

正常に完了したら、次のようになります。

翻訳されたドキュメントはターゲットコンテナーにあります。
成功した POST メソッドから 202 Accepted 応答コードが返され、バッチ要求によってサービスが作成されたことが示されます。
POST 要求では、後続の GET 要求で使用される値を提供する Operation-Location を含む応答ヘッダーも返します。

文書の翻訳に成功しました。問題が発生しました。

Python プロジェクトを設定する

最新バージョンの Python 3.x をまだインストールしていない場合はインストールします。 Python のインストールには、Python インストーラーパッケージ (pip) が含まれます。

ヒント

Python を初めて使う場合は、「Python の概要」Learn モジュールを試してください。
ターミナルウィンドウを開き、pip を使用して Requests ライブラリと uuid0 パッケージをインストールします。
```
pip install requests uuid
```

ストレージコンテナー内のすべてのドキュメントを翻訳する

任意のエディターまたは IDE を使用して、document-translation という名前のアプリ用の新しいディレクトリを作成します。
document-translation ディレクトリに document-translation.py という名前の新しい Python ファイルを作成します。
ドキュメント翻訳のコードサンプルをコピーして、document-translation.py ファイルに貼り付けます。
- {your-document-translation-endpoint} と {your-key} を、Azure portal Translator インスタンスの値で更新します。
- {your-source-container-SAS-URL} と {your-target-container-SAS-URL} を、Azure portal のストレージアカウントコンテナーインスタンスの値で更新します。

コードサンプル

重要

import requests

endpoint = '{your-document-translation-endpoint}'
key =  '{your-key}'
path = 'translator/text/batch/v1.1/batches'
constructed_url = endpoint + path

sourceSASUrl = '{your-source-container-SAS-URL}'

targetSASUrl = '{your-target-container-SAS-URL}'

body= {
    "inputs": [
        {
            "source": {
                "sourceUrl": sourceSASUrl,
                "storageSource": "AzureBlob",
                "language": "en"
            },
            "targets": [
                {
                    "targetUrl": targetSASUrl,
                    "storageSource": "AzureBlob",
                    "category": "general",
                    "language": "es"
                }
            ]
        }
    ]
}
headers = {
  'Ocp-Apim-Subscription-Key': key,
  'Content-Type': 'application/json',
}

response = requests.post(constructed_url, headers=headers, json=body)
response_headers = response.headers

print(f'response status code: {response.status_code}\nresponse status: {response.reason}\n\nresponse headers:\n')

for key, value in response_headers.items():
    print(key, ":", value)

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

アプリケーションにコードサンプルを追加したら、プログラムをビルドして実行します。

document-translation ディレクトリに移動します。
ご利用のコンソールで、次のコマンドを入力して実行します。
```
python document-translation.py
```

正常に完了したら、次のようになります。

翻訳されたドキュメントはターゲットコンテナーにあります。
成功した POST メソッドから 202 Accepted 応答コードが返され、バッチ要求によってサービスが作成されたことが示されます。
POST 要求では、後続の GET 要求で使用される値を提供する Operation-Location を含む応答ヘッダーも返します。

文書の翻訳に成功しました。問題が発生しました。

プログラミング環境のセットアップ

このクイックスタートでは、cURL コマンドラインツールを使用してドキュメント翻訳 REST API 呼び出しを行います。

注意

cURL パッケージは、ほとんどの Windows 10 と Windows 11、およびほとんどの macOS および Linux ディストリビューションにプレインストールされています。パッケージのバージョンは、それぞれのコマンドを使用して確認できます。Windows: curl.exe -V。 macOS curl -V Linux: curl --version

cURL がインストールされていない場合は、お使いのプラットフォームに応じた次のリンクをお使いください。

Windows。
Mac または Linux。

ドキュメントの翻訳 (POST 要求)

任意のエディターまたは IDE を使用して、document-translation という名前のアプリ用の新しいディレクトリを作成します。
document-translation ディレクトリに document-translation.json という名前の新しい json ファイルを作成します。
ドキュメント翻訳の要求サンプルをコピーして、document-translation.json ファイルに貼り付けます。 {your-source-container-SAS-URL} と {your-target-container-SAS-URL} を、Azure portal のストレージアカウントコンテナーインスタンスの値で置き換えます。

**Request sample**
```
{
  "inputs":[
    {
      "source":{
        "sourceUrl":"{your-source-container-SAS-URL}"
      },
      "targets":[
        {
          "targetUrl":"{your-target-container-SAS-URL}",
          "language":"fr"
        }
      ]
    }
  ]
}
```

POST 要求をビルドして実行する

POST 要求を実行する前に、{your-document-translator-endpoint} と {your-key} を、Azure portal Translator インスタンスからの値に置き換えます。

重要

PowerShell

cmd /c curl "{your-document-translator-endpoint}/translator/text/batch/v1.1/batches" -i -X POST --header "Content-Type: application/json" --header "Ocp-Apim-Subscription-Key: {your-key}" --data "@document-translation.json"

コマンドプロンプトまたはターミナル

curl "{your-document-translator-endpoint}/translator/text/batch/v1.1/batches" -i -X POST --header "Content-Type: application/json" --header "Ocp-Apim-Subscription-Key: {your-key}" --data "@document-translation.json"

正常に完了したら、次のようになります。

翻訳されたドキュメントはターゲットコンテナーにあります。
成功した POST メソッドから 202 Accepted 応答コードが返され、バッチ要求によってサービスが作成されたことが示されます。
POST 要求では、後続の GET 要求で使用される値を提供する Operation-Location を含む応答ヘッダーも返します。

以上です。お疲れさまでした。このクイックスタートでは、ドキュメント翻訳を使用して、元の構造とデータ形式を保持しながらドキュメントを翻訳しました。

次のステップ

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

ドキュメント翻訳を使ってみる

前提条件

キーとドキュメント翻訳エンドポイントを取得する

Azure Blob Storage コンテナーを作成する

必要な認証

サンプル ドキュメント

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

Newtonsoft.Json のインストール

ストレージ コンテナー内のすべてのドキュメントを翻訳する

コード サンプル

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

Go 環境を設定する

ストレージ コンテナー内のすべてのドキュメントを翻訳する

コード サンプル

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

Java 環境を設定する

新しい Gradle プロジェクトを作成する

ストレージ コンテナー内のすべてのドキュメントを翻訳する

コード サンプル

Java アプリケーションをビルドして実行する

Node.js 環境を設定する

ストレージ コンテナー内のすべてのドキュメントを翻訳する

コード サンプル

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

Python プロジェクトを設定する

ストレージ コンテナー内のすべてのドキュメントを翻訳する

コード サンプル

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

プログラミング環境のセットアップ

ドキュメントの翻訳 (POST 要求)

POST 要求をビルドして実行する

次のステップ

その他のリソース

サンプルドキュメント

ストレージコンテナー内のすべてのドキュメントを翻訳する

コードサンプル

ストレージコンテナー内のすべてのドキュメントを翻訳する

コードサンプル

ストレージコンテナー内のすべてのドキュメントを翻訳する

コードサンプル

ストレージコンテナー内のすべてのドキュメントを翻訳する

コードサンプル

ストレージコンテナー内のすべてのドキュメントを翻訳する

コードサンプル