Início rápido: traduzir texto programaticamente

Configurar seu projeto do Visual Studio

1. Verifique se você tem a versão atual do Visual Studio IDE.

   Sugestão

   Se você é novo no Visual Studio, tente o módulo Introdução ao Visual Studio Learn.

2. Abra o Visual Studio.

3. Na página inicial, escolha Criar um novo projeto.

   

4. Na página Criar um novo projeto, insira console na caixa de pesquisa. Escolha o modelo Aplicação de Console, em seguida, escolha Avançar.

   

5. Na janela de diálogo Configurar seu novo projeto, digite translator_quickstart na caixa Nome do projeto. Deixe a caixa de seleção "Colocar solução e projeto no mesmo diretório" desmarcada e selecione Avançar.

   

6. Na janela de diálogo Informações adicionais, verifique se .NET 6.0 (Suporte de longo prazo) está selecionado. Deixe a caixa de seleção "Não usar instruções de nível superior" desmarcada e selecione Criar.

   

Instalar o pacote Newtonsoft.json com o NuGet

1. Clique com o botão direito do mouse em seu projeto translator_quickstart e selecione Gerenciar pacotes NuGet... .

   

2. Selecione a guia Procurar e digite Newtonsoft.json.

   

3. Para adicionar o pacote ao seu projeto, selecione instalar na janela correta do gerenciador de pacotes.

   

Crie seu aplicativo C#

1. Abra o arquivo Program.cs .

2. Exclua o código existente, incluindo a linha Console.WriteLine("Hello World!"). Copie e cole o exemplo de código no arquivo Program.cs do seu aplicativo. Certifique-se de atualizar a variável de chave com o valor da sua instância do Tradutor do portal do Azure:

using System.Text;
using Newtonsoft.Json;

class Program
{
    private static readonly string key = "<your-translator-key>";
    private static readonly string endpoint = "https://api.cognitive.microsofttranslator.com";

    // location, also known as region.
    // required if you're using a multi-service or regional (not global) resource. It can be found in the Azure portal on the Keys and Endpoint page.
    private static readonly string location = "<YOUR-RESOURCE-LOCATION>";

    static async Task Main(string[] args)
    {
        // Input and output languages are defined as parameters.
        string route = "/translate?api-version=3.0&from=en&to=fr&to=zu";
        string textToTranslate = "I would really like to drive your car around the block a few times!";
        object[] body = new object[] { new { Text = textToTranslate } };
        var requestBody = JsonConvert.SerializeObject(body);

        using (var client = new HttpClient())
        using (var request = new HttpRequestMessage())
        {
            // Build the request.
            request.Method = HttpMethod.Post;
            request.RequestUri = new Uri(endpoint + route);
            request.Content = new StringContent(requestBody, Encoding.UTF8, "application/json");
            request.Headers.Add("Ocp-Apim-Subscription-Key", key);
            // location required if you're using a multi-service or regional (not global) resource.
            request.Headers.Add("Ocp-Apim-Subscription-Region", location);

            // Send the request and get response.
            HttpResponseMessage response = await client.SendAsync(request).ConfigureAwait(false);
            // Read response as a string.
            string result = await response.Content.ReadAsStringAsync();
            Console.WriteLine(result);
        }
    }
}

Execute seu aplicativo C#

Depois de adicionar um exemplo de código ao seu aplicativo, escolha o botão verde Iniciar ao lado de formRecognizer_quickstart para criar e executar o programa ou pressione F5.

Resultados da tradução:

Após uma chamada bem-sucedida, você verá a seguinte resposta:

[
    {
        "detectedLanguage": {
            "language": "en",
            "score": 1.0
        },
        "translations": [
            {
                "text": "J'aimerais vraiment conduire votre voiture autour du pâté de maisons plusieurs fois!",
                "to": "fr"
            },
            {
                "text": "Ngingathanda ngempela ukushayela imoto yakho endaweni evimbelayo izikhathi ezimbalwa!",
                "to": "zu"
            }
        ]
    }
]

Configurar o ambiente Go

Você pode usar qualquer editor de texto para escrever aplicativos Go. Recomendamos usar a versão mais recente do Visual Studio Code and Go extensão.

1. Certifique-se de que a versão mais recente do Go está instalada:

   • Descarregue a versão da linguagem de programação Go para o seu sistema operativo.

   • Quando o download estiver concluído, execute o instalador.

   • Abra um prompt de comando e digite o seguinte para confirmar que o Go foi instalado:

       go version
     

Crie a sua aplicação Go

1. Em uma janela de console (como cmd, PowerShell ou Bash), crie um novo diretório para seu aplicativo chamado translator-app e navegue até ele.

2. Crie um novo arquivo GO chamado translation.go a partir do diretório translator-app .

3. Copie e cole o exemplo de código fornecido em seu arquivo translation.go . Certifique-se de atualizar a variável de chave com o valor da sua instância do Tradutor do portal do Azure:

package main

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

func main() {
    key := "<YOUR-TRANSLATOR-KEY>"
    endpoint := "https://api.cognitive.microsofttranslator.com/"
    uri := endpoint + "/translate?api-version=3.0"

    // location, also known as region.
    // required if you're using a multi-service or regional (not global) resource. It can be found in the Azure portal on the Keys and Endpoint page.
    location := "<YOUR-RESOURCE-LOCATION>"

    // Build the request URL. See: https://go.dev/pkg/net/url/#example_URL_Parse
    u, _ := url.Parse(uri)
    q := u.Query()
    q.Add("from", "en")
    q.Add("to", "fr")
    q.Add("to", "zu")
    u.RawQuery = q.Encode()

    // Create an anonymous struct for your request body and encode it to JSON
    body := []struct {
        Text string
    }{
        {Text: "I would really like to drive your car around the block a few times."},
    }
    b, _ := json.Marshal(body)

    // Build the HTTP POST request
    req, err := http.NewRequest("POST", u.String(), bytes.NewBuffer(b))
    if err != nil {
        log.Fatal(err)
    }
    // Add required headers to the request
    req.Header.Add("Ocp-Apim-Subscription-Key", key)
    // location required if you're using a multi-service or regional (not global) resource.
    req.Header.Add("Ocp-Apim-Subscription-Region", location)
    req.Header.Add("Content-Type", "application/json")

    // Call the Translator API
    res, err := http.DefaultClient.Do(req)
    if err != nil {
        log.Fatal(err)
    }

    // Decode the JSON response
    var result interface{}
    if err := json.NewDecoder(res.Body).Decode(&result); err != nil {
        log.Fatal(err)
    }
    // Format and print the response to terminal
    prettyJSON, _ := json.MarshalIndent(result, "", "  ")
    fmt.Printf("%s\n", prettyJSON)
}

Execute seu aplicativo Go

Depois de adicionar um exemplo de código ao seu aplicativo, seu programa Go pode ser executado em um prompt de comando ou terminal. Verifique se o caminho do prompt está definido para a pasta translator-app e use o seguinte comando:

 go run translation.go

Resultados da tradução:

Após uma chamada bem-sucedida, você verá a seguinte resposta:

[
    {
        "detectedLanguage": {
            "language": "en",
            "score": 1.0
        },
        "translations": [
            {
                "text": "J'aimerais vraiment conduire votre voiture autour du pâté de maisons plusieurs fois!",
                "to": "fr"
            },
            {
                "text": "Ngingathanda ngempela ukushayela imoto yakho endaweni evimbelayo izikhathi ezimbalwa!",
                "to": "zu"
            }
        ]
    }
]

Configurar seu ambiente Java

• Você deve ter a versão mais recente do Visual Studio Code ou seu IDE preferido. ConsulteJava no Visual Studio Code.

  Sugestão

  • O Visual Studio Code oferece um Coding Pack para Java para Windows e macOS.O pacote de codificação é um pacote de VS Code, o Java Development Kit (JDK) e uma coleção de extensões sugeridas pela Microsoft. O Coding Pack também pode ser usado para corrigir um ambiente de desenvolvimento existente.
  • Se você estiver usando o VS Code e o Coding Pack For Java, instale a extensão Gradle for Java .

• Se você não estiver usando o Visual Studio Code, certifique-se de ter o seguinte instalado em seu ambiente de desenvolvimento:

  • Um Java Development Kit (OpenJDK) de versão 8 ou posterior.

  • Gradle, versão 6.8 ou posterior.

Criar um novo projeto Gradle

1. Na janela do console (como cmd, PowerShell ou Bash), crie um novo diretório para seu aplicativo chamado translator-text-app e navegue até ele.

   mkdir translator-text-app && translator-text-app
   

    mkdir translator-text-app; cd translator-text-app
   

2. Execute o gradle init comando a partir do diretório translator-text-app. Este comando cria arquivos de compilação essenciais para o Gradle, incluindo build.gradle.kts, que é usado em tempo de execução para criar e configurar seu aplicativo.

   gradle init --type basic
   

3. Quando solicitado a escolher uma DSL, selecione Kotlin.

4. Aceite o nome do projeto padrão (translator-text-app) selecionando Return ou Enter.

5. Atualize build.gradle.kts com o seguinte código:

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

Crie sua Aplicação Java

1. No diretório translator-text-app, execute o seguinte comando:

   mkdir -p src/main/java
   

   Você cria a seguinte estrutura de diretórios:

   

2. Navegue até o java diretório e crie um arquivo chamado TranslatorText.java.

   Sugestão

   • Você pode criar um novo arquivo usando o PowerShell.

   • Abra uma janela do PowerShell no diretório do projeto mantendo pressionada a tecla Shift e clicando com o botão direito do mouse na pasta.

   • Digite o seguinte comando New-Item TranslatorText.java.

   • Você também pode criar um novo arquivo em seu IDE chamado TranslatorText.java e salvá-lo no java diretório.

3. Abra o TranslatorText.java arquivo em seu IDE e copie e cole o exemplo de código a seguir em seu aplicativo. Certifique-se de atualizar a chave com um dos valores de chave da sua instância do Tradutor do portal do Azure:

import java.io.IOException;

import com.google.gson.*;
import okhttp3.MediaType;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.RequestBody;
import okhttp3.Response;

public class TranslatorText {
    private static String key = "<your-translator-key";

    // location, also known as region.
   // required if you're using a multi-service or regional (not global) resource. It can be found in the Azure portal on the Keys and Endpoint page.
    private static String location = "<YOUR-RESOURCE-LOCATION>";


    // Instantiates the OkHttpClient.
    OkHttpClient client = new OkHttpClient();

    // This function performs a POST request.
    public String Post() throws IOException {
        MediaType mediaType = MediaType.parse("application/json");
        RequestBody body = RequestBody.create(mediaType,
                "[{\"Text\": \"I would really like to drive your car around the block a few times!\"}]");
        Request request = new Request.Builder()
                .url("https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=fr&to=zu")
                .post(body)
                .addHeader("Ocp-Apim-Subscription-Key", key)
                // location required if you're using a multi-service or regional (not global) resource.
                .addHeader("Ocp-Apim-Subscription-Region", location)
                .addHeader("Content-type", "application/json")
                .build();
        Response response = client.newCall(request).execute();
        return response.body().string();
    }

    // This function prettifies the json response.
    public static String prettify(String json_text) {
        JsonParser parser = new JsonParser();
        JsonElement json = parser.parse(json_text);
        Gson gson = new GsonBuilder().setPrettyPrinting().create();
        return gson.toJson(json);
    }

    public static void main(String[] args) {
        try {
            TranslatorText translateRequest = new TranslatorText();
            String response = translateRequest.Post();
            System.out.println(prettify(response));
        } catch (Exception e) {
            System.out.println(e);
        }
    }
}

Construa e execute seu aplicativo Java

Depois de adicionar um exemplo de código ao seu aplicativo, navegue de volta para o diretório principal do projeto — translator-text-app, abra uma janela do console e insira os seguintes comandos:

1. Crie seu aplicativo com o build comando:

   gradle build
   

2. Execute seu aplicativo com o run comando:

   gradle run
   

Resultados da tradução:

Após uma chamada bem-sucedida, você verá a seguinte resposta:

[
  {
    "translations": [
      {
        "text": "J'aimerais vraiment conduire votre voiture autour du pâté de maisons plusieurs fois!",
        "to": "fr"
      },
      {
        "text": "Ngingathanda ngempela ukushayela imoto yakho endaweni evimbelayo izikhathi ezimbalwa!",
        "to": "zu"
      }
    ]
  }
]

Configurar seu projeto do Node.js Express

1. Certifique-se de que a versão mais recente doNode.jsestá instalada. O Gestor de Pacotes Node (npm) está incluído na instalação do Node.js.

   Sugestão

   Se você é novo no Node.js, experimente o módulo Introdução ao Node.js Learn.

2. Em uma janela de console (como cmd, PowerShell ou Bash), crie e navegue até um novo diretório para seu aplicativo chamado translator-app.

       mkdir translator-app && cd translator-app
   

     mkdir translator-app; cd translator-app
   

3. Execute o comando npm init para inicializar o aplicativo e organizar seu projeto.

      npm init
   

4. Especifique os atributos do seu projeto usando os prompts apresentados no terminal.

   • Os atributos mais importantes são nome, número da versão e ponto de entrada.
   • Recomendamos manter index.js como o nome do ponto de entrada. A descrição, o comando de teste, o repositório GitHub, palavras-chave, autor e informações de licença são atributos opcionais — eles podem ser ignorados para este projeto.
   • Aceite as sugestões entre parênteses selecionando Devolver ou Enter.
   • Depois de concluir os prompts, um package.json arquivo será criado no diretório do aplicativo tradutor.

5. Abra uma janela do console e use npm para instalar a axios biblioteca HTTP e o pacote uuid.

      npm install axios uuid
   

6. Crie o index.js arquivo no diretório do aplicativo.

   Sugestão

   • Você pode criar um novo arquivo usando o PowerShell.

   • Abra uma janela do PowerShell no diretório do projeto mantendo pressionada a tecla Shift e clicando com o botão direito do mouse na pasta.

   • Digite o seguinte comando New-Item index.js.

   • Você também pode criar um novo arquivo nomeado index.js em seu IDE e salvá-lo no translator-app diretório.

Crie seu aplicativo JavaScript

Adicione o exemplo de código a seguir ao seu index.js arquivo. Certifique-se de atualizar a variável de chave com o valor da sua instância do Tradutor do portal do Azure:

    const axios = require('axios').default;
    const { v4: uuidv4 } = require('uuid');

    let key = "<your-translator-key>";
    let endpoint = "https://api.cognitive.microsofttranslator.com";

    // location, also known as region.
    // required if you're using a multi-service or regional (not global) resource. It can be found in the Azure portal on the Keys and Endpoint page.
    let location = "<YOUR-RESOURCE-LOCATION>";

    axios({
        baseURL: endpoint,
        url: '/translate',
        method: 'post',
        headers: {
            'Ocp-Apim-Subscription-Key': key,
             // location required if you're using a multi-service or regional (not global) resource.
            'Ocp-Apim-Subscription-Region': location,
            'Content-type': 'application/json',
            'X-ClientTraceId': uuidv4().toString()
        },
        params: {
            'api-version': '3.0',
            'from': 'en',
            'to': 'fr,zu'
        },
        data: [{
            'text': 'I would really like to drive your car around the block a few times!'
        }],
        responseType: 'json'
    }).then(function(response){
        console.log(JSON.stringify(response.data, null, 4));
    })

Execute seu aplicativo JavaScript

Depois de adicionar o exemplo de código ao seu aplicativo, execute o programa:

1. Navegue até o diretório do aplicativo (translator-app).

2. Digite o seguinte comando no seu terminal:

   node index.js
   

Resultados da tradução:

Após uma chamada bem-sucedida, você verá a seguinte resposta:

[
    {
        "translations": [
            {
                "text": "J'aimerais vraiment conduire votre voiture autour du pâté de maisons plusieurs fois!",
                "to": "fr"
            },
            {
                "text": "Ngingathanda ngempela ukushayela imoto yakho endaweni evimbelayo izikhathi ezimbalwa!",
                "to": "zu"
            }
        ]
    }
]

Configure seu projeto Python

1. Verifique se a versão mais recente do Python 3.x está instalada. O pacote do instalador do Python (pip) está incluído na instalação do Python.

   Sugestão

   Se você é novo no Python, tente o módulo Introdução ao Python Learn.

2. Abra uma janela de terminal e use pip para instalar a biblioteca de solicitações e o pacote uuid0:

      pip install requests uuid
   

   Observação

   Também usamos um pacote integrado do Python chamado json. Ele é usado para trabalhar com dados JSON.

Crie seu aplicativo Python

1. Crie um novo arquivo Python chamado translator-app.py em seu editor ou IDE preferido.

2. Adicione o exemplo de código a seguir ao seu translator-app.py arquivo. Certifique-se de atualizar a chave com um dos valores da sua instância do Tradutor do portal do Azure.

import requests, uuid, json

# Add your key and endpoint
key = "<your-translator-key>"
endpoint = "https://api.cognitive.microsofttranslator.com"

# location, also known as region.
# required if you're using a multi-service or regional (not global) resource. It can be found in the Azure portal on the Keys and Endpoint page.
location = "<YOUR-RESOURCE-LOCATION>"

path = '/translate'
constructed_url = endpoint + path

params = {
    'api-version': '3.0',
    'from': 'en',
    'to': ['fr', 'zu']
}

headers = {
    'Ocp-Apim-Subscription-Key': key,
    # location required if you're using a multi-service or regional (not global) resource.
    'Ocp-Apim-Subscription-Region': location,
    'Content-type': 'application/json',
    'X-ClientTraceId': str(uuid.uuid4())
}

# You can pass more than one object in body.
body = [{
    'text': 'I would really like to drive your car around the block a few times!'
}]

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

print(json.dumps(response, sort_keys=True, ensure_ascii=False, indent=4, separators=(',', ': ')))

Execute seu aplicativo Python

Depois de adicionar um exemplo de código ao seu aplicativo, compile e execute o programa:

1. Navegue até o arquivo translator-app.py .

2. Digite o seguinte comando no console:

   python translator-app.py
   

Resultados da tradução:

Após uma chamada bem-sucedida, você verá a seguinte resposta:

[
  {
    "translations": [
      {
        "text": "J'aimerais vraiment conduire votre voiture autour du pâté de maisons plusieurs fois!",
        "to": "fr"
      },
      {
        "text": "Ngingathanda ngempela ukushayela imoto yakho endaweni evimbelayo izikhathi ezimbalwa!",
        "to": "zu"
      }
    ]
  }
]