文档翻译入门

对于本快速入门，我们将使用最新版本的 Visual Studio IDE 来生成和运行应用程序。

1. 启动 Visual Studio。

2. 在“开始”页面上，选择“新建项目”。

   

3. 在“创建新项目”页面上，在搜索框中输入“控制台”。 选择“控制台应用程序”模板，然后选择“下一步”。

   

4. 在“配置新项目”对话框中，在项目名称框中输入 document-translation-qs。 然后选择“下一步”。

   

5. 在“附加信息”对话框窗口中，选择“.NET 6.0 (长期支持)”，然后选择“创建”。

   

1. 右键单击“document-translation-qs”项目并选择“管理 NuGet 包...”。

   

2. 选择“浏览”选项卡并输入“NewtonsoftJson”。

   

3. 从下拉菜单中选择最新的稳定版本，并在项目中安装该包。

   

1. 打开 Program.cs 文件。

2. 删除现有的代码，包括 Console.Writeline("Hello World!") 行。

3. 将文档翻译代码示例复制并粘贴到 Program.cs 文件中。

   • 使用 Azure 门户翻译器实例中的值更新 {your-document-translation-endpoint} 和 {your-key}。

   • 使用 Azure 门户存储帐户容器实例中的值更新 {your-source-container-SAS-URL} 和 {your-target-container-SAS-URL}。

using System.Text;

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

    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。

:::image type="content" source="../../media/visual-studio/run-visual-studio.png" alt-text="Screenshot: run your Visual Studio program.":::

成功完成后：

• 可以在目标容器中找到已翻译的文档。
• 成功的 POST 方法返回 202 Accepted 响应代码，指示服务创建了批处理请求。
• POST 请求还返回包含 Operation-Location 的响应标头，这些标头提供在后续 GET 请求中使用的值。

你可以使用任何文本编辑器来编写 Go 应用程序。 建议使用最新版本的 Visual Studio Code 和 Go 扩展。

请下载并安装 Go（如果尚未这样做）。

1. 下载适用于你的操作系统的 Go 版本。

2. 下载完成后，运行安装程序。

3. 打开命令提示符并输入以下命令，以确认 Go 是否已安装：

    ```console
      go version
    ```
   

1. 在控制台窗口（例如 cmd、PowerShell 或 Bash）中，为应用创建一个名为“document-translation-qs”的新目录，然后导航至该目录。

2. 在“document-translation-qs”目录中创建一个名为“document-translation.go”的新 Go 文件。

3. 将文档翻译代码示例复制并粘贴到“document-translation.go”文件中。

   • 使用 Azure 门户翻译器实例中的值更新 {your-document-translation-endpoint} 和 {your-key}。

   • 使用 Azure 门户存储帐户容器实例中的值更新 {your-source-container-SAS-URL} 和 {your-target-container-SAS-URL}。

package main

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

func main() {

    httpposturl := "{your-document-translation-endpoint}/translator/text/batch/v1.0/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 程序。 确保提示路径设置为“document-translation-qs”文件夹并使用以下命令：

```console
 go run document-translation.go
```

成功完成后：

• 可以在目标容器中找到已翻译的文档。
• 成功的 POST 方法返回 202 Accepted 响应代码，指示服务创建了批处理请求。
• POST 请求还返回包含 Operation-Location 的响应标头，这些标头提供在后续 GET 请求中使用的值。

对于本快速入门，我们会使用 Gradle 生成自动化工具来创建和运行应用程序。

• 应使用最新版本的 Visual Studio Code 或者你首选的 IDE。 请参阅 Visual Studio Code 中的 Java。

  提示

  • Visual Studio Code 提供适用于 Windows 和 macOS 的 "Java 编码包"。该编码包是 VS Code、Java 开发工具包 (JDK) 和 Microsoft 建议扩展的集合。 编码包还可用于修复现有开发环境。
  • 如果使用 VS Code 和适用于 Java 的编码包，请安装 Gradle for Java 扩展。

• 如果不使用 Visual Studio Code，请确保在开发环境中安装了以下内容：

  • Java 开发工具包 (OpenJDK) 版本 8 或更高版本。

  • Gradle 版本 6.8 或更高版本。

1. 在控制台窗口（例如 cmd、PowerShell 或 Bash）中，为应用创建一个名为“document-translation”的新目录，然后导航至该目录。

   mkdir document-translation && document-translation
   

    mkdir document-translation; cd document-translation
   

2. 从 document-translation 目录运行 gradle init 命令。 此命令将创建 Gradle 的基本生成文件，其中包括 build.gradle.kts - 在运行时将使用该文件创建并配置应用程序。

   gradle init --type basic
   

3. 当提示你选择一个 DSL 时，选择 Kotlin。

4. 按 Return 或 Enter 接受默认项目名称 (document-translation)。

   备注

   创建整个应用程序可能需要几分钟的时间，但很快就会看到几个文件夹和文件，包括 build-gradle.kts。

5. 使用以下代码更新 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")
}

1. 在 document-translation 目录中，运行以下命令：

   mkdir -p src/main/java
   

   该命令创建以下目录结构：

   

2. 导航到 java 目录，创建一个名为 DocumentTranslation.java 的文件。

   提示

   • 可以使用 Powershell 创建新文件。

   • 按住 Shift 键并右键单击该文件夹，在项目目录中打开 Powershell 窗口。

   • 输入以下命令 "New-Item DocumentTranslation.java"。

   • 还可以在 IDE 中创建名为 DocumentTranslation.java 的新文件并将其保存到 java 目录。

3. 将文档翻译代码示例复制并粘贴到“DocumentTranslation.java”文件中。

   • 使用 Azure 门户翻译器实例中的值更新 {your-document-translation-endpoint} 和 {your-key}。

   • 使用 Azure 门户存储帐户容器实例中的值更新 {your-source-container-SAS-URL} 和 {your-target-container-SAS-URL}。

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.0";

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

• 将代码示例添加到应用程序后，导航回主项目目录“document-translation”，打开控制台窗口，然后输入以下命令：

  1. 使用 build 命令生成应用程序：

     gradle build
     

  2. 使用 run 命令运行应用程序：

     gradle run
     

成功完成后：

• 可以在目标容器中找到已翻译的文档。
• 成功的 POST 方法返回 202 Accepted 响应代码，指示服务创建了批处理请求。
• POST 请求还返回包含 Operation-Location 的响应标头，这些标头提供在后续 GET 请求中使用的值。

对于本快速入门，我们会使用 Node.js JavaScript 运行时环境来创建和运行应用程序。

1. 安装最新版本的 Node.js（如果尚未这样做）。 Node.js 安装中包含了 Node 包管理器 (npm)。

   提示

   如果你不熟悉 Node.js，请尝试学习 Node.js 简介 Learn 模块。

2. 在控制台窗口（例如 cmd、PowerShell 或 Bash）中，为应用创建名为 document-translation 的新目录，并导航到该目录。

   mkdir document-translation && cd document-translation
   

   mkdir document-translation; cd document-translation
   

3. 运行 npm init 命令以初始化应用程序并为项目构建基架。

   npm init
   

4. 通过接受终端中显示的提示来指定项目的属性。

   • 最重要的属性包括名称、版本号和入口点。
   • 建议保留 index.js 作为入口点名称。 描述、测试命令、GitHub 存储库、关键字、作者和许可证信息均为可选属性 —— 在此项目中可跳过。
   • 通过选择“Return”或“Enter”，接受括号中的建议。
   • 完成提示后，将在 document-translation 目录中创建一个 package.json 文件。

5. 使用 npm 在 document-translation 应用目录中安装 axios HTTP 库和 uuid 包：

   npm install axios uuid
   

1. 创建应用目录中的 index.js 文件。

   提示

   • 可以使用 Powershell 创建新文件。

   • 按住 Shift 键并右键单击该文件夹，在项目目录中打开 Powershell 窗口。

   • 输入以下命令：New-Item index.js。

   • 还可以在 IDE 中创建名为 index.js 的新文件并将其保存到 document-translation 目录。

2. 将文档翻译代码示例复制并粘贴到 index.js 文件中。

   • 使用 Azure 门户翻译器实例中的值更新 {your-document-translation-endpoint} 和 {your-key}。

   • 使用 Azure 门户存储帐户容器实例中的值更新 {your-source-container-SAS-URL} 和 {your-target-container-SAS-URL}。

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

let endpoint = '{your-document-translation-endpoint}/translator/text/batch/v1.0';
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);
});

将代码示例添加到应用程序后，运行程序：

1. 导航到应用程序目录 (document-translation)。

2. 在终端中输入并运行以下命令：

   node index.js
   

成功完成后：

• 可以在目标容器中找到已翻译的文档。
• 成功的 POST 方法返回 202 Accepted 响应代码，指示服务创建了批处理请求。
• POST 请求还返回包含 Operation-Location 的响应标头，这些标头提供在后续 GET 请求中使用的值。

1. 安装最新版本的 Python 3.x（如果尚未这样做）。 Python 安装中包含了 Python 安装程序包 (pip)。

   提示

   如果你不熟悉 Python，请尝试学习 Python 简介 Learn 模块。

2. 打开终端窗口，并使用 pip 安装 Requests 库和 uuid0 包：

   pip install requests uuid
   

1. 使用首选编辑器或 IDE，为应用创建一个名为 document-translation 的新目录。

2. 在“document-translation”目录中创建一个名为“document-translation.py”的新 Python 文件。

3. 将文档翻译代码示例复制并粘贴到 document-translation.py 文件中。

   • 使用 Azure 门户翻译器实例中的值更新 {your-document-translation-endpoint} 和 {your-key}。

   • 使用 Azure 门户存储帐户容器实例中的值更新 {your-source-container-SAS-URL} 和 {your-target-container-SAS-URL}。

import requests

endpoint = '{your-document-translation-endpoint}'
key =  '{your-key}'
path = 'translator/text/batch/v1.0/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)

将代码示例添加到应用程序后，构建并运行程序：

1. 导航到“document-translation”目录。

2. 在控制台中输入并运行以下命令：

   python document-translation.py
   

成功完成后：

• 可以在目标容器中找到已翻译的文档。
• 成功的 POST 方法返回 202 Accepted 响应代码，指示服务创建了批处理请求。
• POST 请求还返回包含 Operation-Location 的响应标头，这些标头提供在后续 GET 请求中使用的值。

在本快速入门中，我们使用 cURL 命令行工具进行文档翻译 REST API 调用。

如果尚未安装 cURL，以下是适用于平台的链接：

• Windows。
• Mac 或 Linux。

1. 使用首选编辑器或 IDE，为应用创建一个名为 document-translation 的新目录。

2. 在“document-translation”目录中创建一个名为“document-translation.json”的新 json 文件。

3. 将文档翻译“请求示例”复制并粘贴到 document-translation.json 文件中。 使用 Azure 门户存储帐户容器实例中的值替换 {your-source-container-SAS-URL} 和 {your-target-container-SAS-URL}。

   **Request sample**

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

在运行 POST 请求之前，将 {your-source-container-SAS-URL} 和 {your-key} 替换为 Azure 门户翻译器实例中的终结点值。

PowerShell

cmd /c curl "{your-document-translator-endpoint}/translator/text/batch/v1.0/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.0/batches" -i -X POST --header "Content-Type: application/json" --header "Ocp-Apim-Subscription-Key: {your-key}" --data "@document-translation.json"

成功完成后：

• 可以在目标容器中找到已翻译的文档。
• 成功的 POST 方法返回 202 Accepted 响应代码，指示服务创建了批处理请求。
• POST 请求还返回包含 Operation-Location 的响应标头，这些标头提供在后续 GET 请求中使用的值。