Zaman uyumsuz belge çevirisi kullanmaya başlama

Makale
02/23/2024

Belge Çevirisi, Azure AI Çeviri hizmetinin desteklenen dillerde ve çeşitli dosya biçimlerinde belgelerin tamamını zaman uyumsuz olarak çeviren bulut tabanlı bir özelliğidir. Bu hızlı başlangıçta, kaynak belgeyi hedef dile çevirmek için seçtiğiniz bir programlama diliyle Belge Çevirisi'ni kullanmayı ve yapıyı ve metin biçimlendirmesini korumayı öğrenin.

Önkoşullar

Önemli

Java ve JavaScript Belge Çevirisi SDK'ları şu anda genel önizlemede kullanılabilir. Özellikler, yaklaşımlar ve süreçler, genel kullanılabilirlik (GA) sürümünden önce, kullanıcı geri bildirimlerine bağlı olarak değişebilir.
C# ve Python SDK'ları, üretim uygulamalarınızda kullanıma hazır genel kullanılabilirlik (GA) sürümleridir
Belge Çevirisi şu anda yalnızca Çeviri (tek hizmetli) kaynakta desteklenir ve Azure AI hizmetleri (çok hizmetli) kaynağına dahil değildir.
Belge Çevirisi yalnızca S1 Standart Hizmet Planı'nda (kullandıkça öde) veya D3 Toplu İndirim Planı'nda desteklenir. Bkz.Azure AI hizmetleri fiyatlandırması— Çeviri.

Başlamak için gerekli olanlar:

Etkin bir Azure hesabı. Hesabınız yoksa ücretsiz bir hesap oluşturabilirsiniz
bir Azure Blob Depolama hesabı. Ayrıca kaynak ve hedef dosyalarınız için Azure Blob Depolama hesabınızda kapsayıcılar oluşturmanız gerekir:
- Kaynak kapsayıcı. Bu kapsayıcı, dosyalarınızı çeviri için karşıya yüklediğiniz yerdir (gerekli).
- Hedef kapsayıcı. Bu kapsayıcı, çevrilen dosyalarınızın depolandığı yerdir (gereklidir).
Tek hizmetli Çeviri kaynağı (çok hizmetli bir Azure AI hizmetleri kaynağı değil):

Çeviri proje ve örnek ayrıntıları alanlarını aşağıdaki gibi tamamlayın:
1. Abonelik. Kullanılabilir Azure aboneliklerinizden birini seçin.
2. Kaynak Grubu. Yeni bir kaynak grubu oluşturabilir veya kaynağınızı aynı yaşam döngüsünü, izinleri ve ilkeleri paylaşan önceden var olan bir kaynak grubuna ekleyebilirsiniz.
3. Kaynak Bölgesi. İşletmeniz veya uygulamanız belirli bir bölge gerektirmediği sürece Genel'i seçin. Kimlik doğrulaması için sistem tarafından atanan yönetilen kimlik kullanmayı planlıyorsanız Batı ABD gibi bir coğrafi bölge seçin.
4. Adı. Kaynağınız için seçtiğiniz adı girin. Seçtiğiniz ad Azure içinde benzersiz olmalıdır.
  
  Not
  
  Belge Çevirisi için özel bir etki alanı uç noktası gerekir. Ad alanına girdiğiniz değer, uç noktanız için özel etki alanı adı parametresi olacaktır.
5. Fiyatlandırma katmanı. Belge Çevirisi ücretsiz katmanda desteklenmez. Hizmeti denemek için Standart S1'i seçin.
6. Gözden geçir + Oluştur’u seçin.
7. Hizmet koşullarını gözden geçirin ve kaynağınızı dağıtmak için Oluştur'u seçin.
8. Kaynağınız başarıyla dağıtıldıktan sonra Kaynağa git'i seçin.

Anahtarınızı ve belge çevirisi uç noktanızı alma

Çeviri hizmetine yönelik istekler, erişimin kimliğini doğrulamak için salt okunur bir anahtar ve özel uç nokta gerektirir. Özel etki alanı uç noktası kaynak adınız, ana bilgisayar adınız ve Çeviri alt dizinlerinizle biçimlendirilmiş bir URL'dir ve Azure portalında kullanılabilir.

Yeni bir kaynak oluşturduysanız, dağıtıldıktan sonra Kaynağa git'i seçin. Mevcut bir Belge Çevirisi kaynağınız varsa doğrudan kaynak sayfanıza gidin.
Sol rayda, Kaynak Yönetimi'nin altında Anahtarlar ve Uç Nokta'yı seçin.
belge çevirisi hizmetine isteğinizin kimliğini doğrulamak için ve kod örneklerine kopyalayıp yapıştırabilirsiniz keydocument translation endpoint . API çağrısı yapmak için yalnızca bir anahtar gerekir.

Azure Blob Depolama kapsayıcıları oluşturma

Kaynak ve hedef dosyalar için Azure Blob Depolama hesabınızda kapsayıcılaroluşturmanız gerekir.

Kaynak kapsayıcı. Bu kapsayıcı, dosyalarınızı çeviri için karşıya yüklediğiniz yerdir (gerekli).
Hedef kapsayıcı. Bu kapsayıcı, çevrilen dosyalarınızın depolandığı yerdir (gereklidir).

Gerekli kimlik doğrulaması

sourceUrl , targetUrl ve isteğe bağlıglossaryUrl, sorgu dizesi olarak eklenmiş bir Paylaşılan Erişim İmzası (SAS) belirteci içermelidir. Belirteç kapsayıcınıza veya belirli bloblara atanabilir. Bkz. Belge Çevirisi işlemi için SAS belirteçleri oluşturma.

Kaynak kapsayıcınızın veya blobunuzun okuma ve liste erişimi belirlemesi gerekir.
Hedef kapsayıcınızın veya blobunuzun yazma ve liste erişimi belirlemesi gerekir.
Sözlük blobunuzun okuma ve liste erişimi belirlemesigerekir.

İpucu

Bir işlemde birden çok dosya (blob) çeviriyorsanız, kapsayıcı düzeyinde SAS erişimini temsilci olarak belirleyin.
Bir işlemde tek bir dosyayı (blob) çeviriyorsanız, blob düzeyinde SAS erişimini temsilci olarak belirleyin.
SAS belirteçlerine alternatif olarak, kimlik doğrulaması için sistem tarafından atanan yönetilen kimliği kullanabilirsiniz.

Örnek belge

Bu proje için kaynak kapsayıcınıza yüklenmiş bir kaynak belge gerekir. Bu hızlı başlangıç için belge çevirisi örnek belgemizi indirebilirsiniz. Kaynak dil İngilizcedir.

C#/.NET ortamınızı ayarlama

Bu hızlı başlangıçta, uygulamayı derlemek ve çalıştırmak için Visual Studio IDE'nin en son sürümünü kullanırız.

Visual Studio’yu çalıştırın.
Başlarken sayfasında Yeni proje oluştur'u seçin.
Yeni proje oluştur sayfasında, arama kutusuna konsol yazın. Konsol Uygulaması şablonunu ve ardından İleri'yi seçin.
Yeni projenizi yapılandırın iletişim penceresinde Proje adı kutusuna girindocument-translation-qs. Ardından İleri'yi seçin.
Ek bilgiler iletişim kutusunda .NET 6.0 (uzun süreli destek) öğesini ve ardından Oluştur'u seçin.

Newtonsoft.Json yükleme

Document-translation-qs projenize sağ tıklayın ve NuGet Paketlerini Yönet... öğesini seçin.
Gözat sekmesini seçin ve NewtonsoftJson yazın.
Açılan menüden en son kararlı sürümü seçin ve paketi projenize yükleyin.

Depolama kapsayıcısında tüm belgeleri çevirme

Not

.NET 6'dan başlayarak, şablonu kullanan console yeni projeler önceki sürümlerden farklı yeni bir program stili oluşturur.
Yeni çıkış, yazmanız gereken kodu basitleştiren son C# özelliklerini kullanır.
Daha yeni sürümü kullandığınızda, yalnızca yönteminin gövdesini Main yazmanız gerekir. Üst düzey deyimleri, genel using yönergelerini veya örtük using yönergelerini eklemeniz gerekmez.
Daha fazla bilgi için bkz . Yeni C# şablonları üst düzey deyimler oluşturma.

Program.cs dosyasını açın.
satırı Console.WriteLine("Hello World!")da dahil olmak üzere önceden var olan kodu silin.
Belge çevirisi kodu örneğini kopyalayıp Program.cs dosyasına yapıştırın.
- Azure portal Çeviri örneğinizdeki değerlerle ve {your-key} değerlerini güncelleştirin{your-document-translation-endpoint}.
- Azure portal Depolama hesap kapsayıcıları örneğinizdeki değerlerle ve {your-target-container-SAS-URL} değerlerini güncelleştirin{your-source-container-SAS-URL}.

Kod örneği

Önemli

İşiniz bittiğinde anahtarı kodunuzdan kaldırmayı unutmayın ve asla herkese açık olarak göndermeyin. Üretim için Azure Key Vault gibi kimlik bilgilerinizi depolamanın ve bunlara erişmenin güvenli bir yolunu kullanın. Daha fazla bilgi için bkz . Azure AI hizmetleri güvenliği.

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

        }

    }

}

Uygulamanızı çalıştırma

Uygulamanıza bir kod örneği ekledikten sonra, programınızı derlemek ve çalıştırmak için document-translation-qs öğesinin yanındaki yeşil Başlangıç düğmesini seçin veya F5 tuşuna basın.

Screenshot: run your Visual Studio program.

Başarıyla tamamlandıktan sonra:

Çevrilen belgeler hedef kapsayıcınızda bulunabilir.
Başarılı POST yöntemi, hizmetin toplu iş isteğini oluşturduğunu belirten bir 202 Accepted yanıt kodu döndürür.
POST isteği, sonraki GET isteklerinde kullanılan bir değer sağlayan yanıt üst bilgilerini Operation-Location de döndürür.

Go ortamınızı ayarlama

Go uygulamaları yazmak için herhangi bir metin düzenleyicisini kullanabilirsiniz. Visual Studio Code'un en son sürümünü ve Go uzantısını kullanmanızı öneririz.

İpucu

Go'yu kullanmaya yeni başladıysanız Go Learn ile çalışmaya başlama modülünü deneyin.

Henüz yapmadıysanız Go'u indirip yükleyin.

İşletim sisteminiz için Go sürümünü indirin.
İndirme işlemi tamamlandıktan sonra yükleyiciyi çalıştırın.
Bir komut istemi açın ve Go'nun yüklendiğini onaylamak için aşağıdakileri girin:
```
go version
```

Depolama kapsayıcısında tüm belgeleri çevirme

Konsol penceresinde (cmd, PowerShell veya Bash gibi), uygulamanız için document-translation-qs adlı yeni bir dizin oluşturun ve bu dizine gidin.
document-translation-qs dizininde document-translation.go adlı yeni bir Go dosyası oluşturun.
Belge çevirisi kodu örneğini kopyalayıp document-translation.go dosyanıza yapıştırın.
- Azure portal Çeviri örneğinizdeki değerlerle ve {your-key} değerlerini güncelleştirin{your-document-translation-endpoint}.
- ve {your-target-container-SAS-URL} değerini {your-source-container-SAS-URL} Azure portal Depolama hesap kapsayıcıları örneğinizdeki değerlerle güncelleştirin.

Kod örneği

Önemli

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 uygulamanızı çalıştırma

Uygulamanıza bir kod örneği ekledikten sonra Go programınız bir komut veya terminal isteminde yürütülebilir. İsteminizin yolunun document-translation-qs klasörüne ayarlandığından emin olun ve aşağıdaki komutu kullanın:

go run document-translation.go

Başarıyla tamamlandıktan sonra:

Çevrilen belgeler hedef kapsayıcınızda bulunabilir.
Başarılı POST yöntemi, hizmetin toplu iş isteğini oluşturduğunu belirten bir 202 Accepted yanıt kodu döndürür.
POST isteği, sonraki GET isteklerinde kullanılan bir değer sağlayan yanıt üst bilgilerini Operation-Location de döndürür.

Belgemi başarıyla çevirdim.Bir sorunla karşılaştım.

Java ortamınızı ayarlama

Bu hızlı başlangıçta, uygulamayı oluşturmak ve çalıştırmak için Gradle derleme otomasyon aracını kullanırız.

Visual Studio Code'un en son sürümüne veya tercih ettiğiniz IDE'ye sahip olmanız gerekir. Bkz.Visual Studio Code'da Java.
İpucu
- Visual Studio Code, Windows ve macOS için Java için bir Kodlama Paketi sunar.Kodlama paketi, BIR VS Code paketi, Java Geliştirme Seti (JDK) ve Microsoft tarafından önerilen uzantılardan oluşan bir koleksiyondur. Kodlama Paketi, mevcut geliştirme ortamını düzeltmek için de kullanılabilir.
- VS Code ve Java için Kodlama Paketi kullanıyorsanız Java için Gradle uzantısını yükleyin.
Visual Studio Code kullanmıyorsanız, geliştirme ortamınızda aşağıdakilerin yüklü olduğundan emin olun:
- Java Geliştirme Seti (OpenJDK) sürüm 8 veya üzeri.
- Gradle, sürüm 6.8 veya üzeri.

Yeni Gradle projesi oluşturma

Konsol penceresinde (cmd, PowerShell veya Bash gibi), uygulamanız için belge çevirisi adlı yeni bir dizin oluşturun ve bu dizine gidin.
```
mkdir document-translation && document-translation
```
```
mkdir document-translation; cd document-translation
```
Belge çevirisi gradle init dizininden komutunu çalıştırın. Bu komut, uygulamanızı oluşturmak ve yapılandırmak için çalışma zamanında kullanılan build.gradle.kts dahil olmak üzere Gradle için temel derleme dosyaları oluşturur.
```
gradle init --type basic
```
DSL seçmeniz istendiğinde Kotlin'i seçin.
İade veya Enter'ı seçerek varsayılan proje adını (belge çevirisi) kabul edin.

Not

Uygulamanın tamamının oluşturulması birkaç dakika sürebilir, ancak yakında dahil olmak üzere build-gradle.ktsbirkaç klasör ve dosya görmeniz gerekir.
Aşağıdaki kodla güncelleştirin 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")
}

Depolama kapsayıcısında tüm belgeleri çevirme

Belge çevirisi dizininden aşağıdaki komutu çalıştırın:
```
mkdir -p src/main/java
```
komutu aşağıdaki dizin yapısını oluşturur:
dizinine java gidin ve adlı DocumentTranslation.javabir dosya oluşturun.
İpucu
- PowerShell kullanarak yeni bir dosya oluşturabilirsiniz.
- Shift tuşunu basılı tutarak ve klasöre sağ tıklayarak proje dizininizde bir PowerShell penceresi açın.
- Yeni Öğe DocumentTranslation.java aşağıdaki komutu girin.
- Ayrıca, IDE'nizde adlı DocumentTranslation.java yeni bir dosya oluşturabilir ve bunu dizine java kaydedebilirsiniz.
Belge çevirisi kodu örneğini kopyalayıp DocumentTranslation.java dosyanıza yapıştırın.
- Azure portal Çeviri örneğinizdeki değerlerle ve {your-key} değerlerini güncelleştirin{your-document-translation-endpoint}.
- ve {your-target-container-SAS-URL} değerini {your-source-container-SAS-URL} Azure portal Depolama hesap kapsayıcıları örneğinizdeki değerlerle güncelleştirin.

Kod örneği

Önemli

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 uygulamanızı derleme ve çalıştırma

Uygulamanıza bir kod örneği ekledikten sonra ana proje dizininize( belge çevirisi) geri gidin, bir konsol penceresi açın ve aşağıdaki komutları girin:
1. Uygulamanızı şu komutla build oluşturun:
```
gradle build
```
2. Uygulamanızı şu komutla run çalıştırın:
```
gradle run
```

Başarıyla tamamlandıktan sonra:

Çevrilen belgeler hedef kapsayıcınızda bulunabilir.
Başarılı POST yöntemi, hizmetin toplu iş isteğini oluşturduğunu belirten bir 202 Accepted yanıt kodu döndürür.
POST isteği, sonraki GET isteklerinde kullanılan bir değer sağlayan yanıt üst bilgilerini Operation-Location de döndürür.

Belgemi başarıyla çevirdim.Bir sorunla karşılaştım.

Node.js ortamınızı ayarlama

Bu hızlı başlangıçta, uygulamayı oluşturmak ve çalıştırmak için Node.js JavaScript çalışma zamanı ortamını kullanacağız.

Henüz yapmadıysanız Node.js'nin en son sürümünü yükleyin. Düğüm Paket Yöneticisi (npm) Node.js yüklemesine dahil edilir.

İpucu

Node.js'yi yeni kullanıyorsanız Node.js Learn'e Giriş modülünü deneyin.
Konsol penceresinde (cmd, PowerShell veya Bash gibi), uygulamanız için adlı document-translationyeni bir dizin oluşturun ve bu dizine gidin.
```
mkdir document-translation && cd document-translation
```
```
mkdir document-translation; cd document-translation
```
Uygulamayı başlatmak ve projenizin iskelesini yapmak için npm init komutunu çalıştırın.
```
npm init
```
Terminalde sunulan istemleri kabul ederek projenizin özniteliklerini belirtin.
- En önemli öznitelikler ad, sürüm numarası ve giriş noktasıdır.
- Giriş noktası adı için saklamanızı index.js öneririz. Açıklama, test komutu, GitHub deposu, anahtar sözcükler, yazar ve lisans bilgileri isteğe bağlı özniteliklerdir; bunlar bu proje için atlanabilir.
- İade veya Enter'ı seçerek önerileri parantez içinde kabul edin.
- İstemleri tamamladıktan sonra, belge çevirisi dizininizde bir package.json dosya oluşturulur.
HTTP kitaplığını axios ve uuid paketini belge çevirisi uygulama dizininize yüklemek için npm kullanın:
```
npm install axios uuid
```

Depolama kapsayıcısında tüm belgeleri çevirme

index.js Dosyayı uygulama dizininde oluşturun.
İpucu
- PowerShell kullanarak yeni bir dosya oluşturabilirsiniz.
- Shift tuşunu basılı tutarak ve klasöre sağ tıklayarak proje dizininizde bir PowerShell penceresi açın.
- Yeni Öğe index.js aşağıdaki komutu girin.
- Ayrıca, IDE'nizde adlı index.js yeni bir dosya oluşturabilir ve bunu dizine document-translation kaydedebilirsiniz.
Belge çevirisi kodu örneğini kopyalayıp dosyanıza index.js yapıştırın.
- Azure portal Çeviri örneğinizdeki değerlerle ve {your-key} değerlerini güncelleştirin{your-document-translation-endpoint}.
- ve {your-target-container-SAS-URL} değerini {your-source-container-SAS-URL} Azure portal Depolama hesap kapsayıcıları örneğinizdeki değerlerle güncelleştirin.

Kod örneği

Önemli

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 uygulamanızı çalıştırma

Kod örneğini uygulamanıza ekledikten sonra programınızı çalıştırın:

Uygulama dizininize (belge çevirisi) gidin.
Terminalinizde aşağıdaki komutu girin ve çalıştırın:
```
node index.js
```

Başarıyla tamamlandıktan sonra:

Çevrilen belgeler hedef kapsayıcınızda bulunabilir.
Başarılı POST yöntemi, hizmetin toplu iş isteğini oluşturduğunu belirten bir 202 Accepted yanıt kodu döndürür.
POST isteği, sonraki GET isteklerinde kullanılan bir değer sağlayan yanıt üst bilgilerini Operation-Location de döndürür.

Belgemi başarıyla çevirdim.Bir sorunla karşılaştım.

Python projenizi ayarlama

Henüz yapmadıysanız Python 3.x'in en son sürümünü yükleyin. Python yükleyici paketi (pip) Python yüklemesine dahil edilir.

İpucu

Python'da yeniyseniz Python Learn'e Giriş modülünü deneyin.
Bir terminal penceresi açın ve İstekler kitaplığını ve uuid0 paketini yüklemek için pip kullanın:
```
pip install requests uuid
```

Depolama kapsayıcısında tüm belgeleri çevirme

Tercih ettiğiniz düzenleyiciyi veya IDE'yi kullanarak uygulamanız için adlı document-translationyeni bir dizin oluşturun.
Belge çevirisi dizininizde document-translation.py adlı yeni bir Python dosyası oluşturun.
Belge çevirisi kodu örneğini kopyalayıp dosyanıza document-translation.py yapıştırın.
- Azure portal Çeviri örneğinizdeki değerlerle ve {your-key} değerlerini güncelleştirin{your-document-translation-endpoint}.
- ve {your-target-container-SAS-URL} değerini {your-source-container-SAS-URL} Azure portal Depolama hesap kapsayıcıları örneğinizdeki değerlerle güncelleştirin.

Kod örneği

Önemli

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 uygulamanızı çalıştırma

Uygulamanıza bir kod örneği ekledikten sonra programınızı derleyip çalıştırın:

Belge çevirisi dizininize gidin.
Konsolunuzda aşağıdaki komutu girin ve çalıştırın:
```
python document-translation.py
```

Başarıyla tamamlandıktan sonra:

Çevrilen belgeler hedef kapsayıcınızda bulunabilir.
Başarılı POST yöntemi, hizmetin toplu iş isteğini oluşturduğunu belirten bir 202 Accepted yanıt kodu döndürür.
POST isteği, sonraki GET isteklerinde kullanılan bir değer sağlayan yanıt üst bilgilerini Operation-Location de döndürür.

Belgemi başarıyla çevirdim.Bir sorunla karşılaştım.

Programlama ortamınızı ayarlama

Bu hızlı başlangıçta, Belge Çevirisi REST API çağrıları yapmak için cURL komut satırı aracını kullanacağız.

Not

cURL paketi çoğu Windows 10 ve Windows 11'e ve çoğu macOS ve Linux dağıtımına önceden yüklenmiştir. Paket sürümünü şu komutlarla de kontrol edebilirsiniz: Windows: curl.exe -V. macOS curl -V Linux: curl --version

cURL yüklü değilse, platformunuzun bağlantıları şunlardır:

Belgeleri çevirme (POST İsteği)

Tercih ettiğiniz düzenleyiciyi veya IDE'yi kullanarak uygulamanız için adlı document-translationyeni bir dizin oluşturun.
Belge çevirisi dizininizde document-translation.json adlı yeni bir json dosyası oluşturun.
Belge çevirisi isteği örneğini kopyalayıp dosyanıza document-translation.json yapıştırın. ve {your-target-container-SAS-URL} değerlerini Azure portal Depolama hesap kapsayıcıları örneğinizdeki değerlerle değiştirin{your-source-container-SAS-URL}.

İstek örneği:
```
{
  "inputs":[
    {
      "source":{
        "sourceUrl":"{your-source-container-SAS-URL}"
      },
      "targets":[
        {
          "targetUrl":"{your-target-container-SAS-URL}",
          "language":"fr"
        }
      ]
    }
  ]
}
```

POST isteğini derleme ve çalıştırma

POST isteğini çalıştırmadan önce ve {your-key} değerini Azure portal Çeviri örneğinizdeki değerlerle değiştirin{your-document-translator-endpoint}.

Önemli

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"

komut istemi / terminal

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"

Başarıyla tamamlandıktan sonra:

Çevrilen belgeler hedef kapsayıcınızda bulunabilir.
Başarılı POST yöntemi, hizmetin toplu iş isteğini oluşturduğunu belirten bir 202 Accepted yanıt kodu döndürür.
POST isteği, sonraki GET isteklerinde kullanılan bir değer sağlayan yanıt üst bilgilerini Operation-Location de döndürür.

İşte bu kadar, tebrikler! Bu hızlı başlangıçta, belgenin özgün yapısını ve veri biçimini koruyarak belgeyi çevirmek için Belge Çevirisi kullandınız.

Sonraki adımlar

Belge Çevirisi işlemleri hakkında daha fazla bilgi edinin

Share via

Zaman uyumsuz belge çevirisi kullanmaya başlama

Önkoşullar

Anahtarınızı ve belge çevirisi uç noktanızı alma

Azure Blob Depolama kapsayıcıları oluşturma

Gerekli kimlik doğrulaması

Örnek belge

C#/.NET ortamınızı ayarlama

Newtonsoft.Json yükleme

Depolama kapsayıcısında tüm belgeleri çevirme

Kod örneği

Uygulamanızı çalıştırma

Go ortamınızı ayarlama

Depolama kapsayıcısında tüm belgeleri çevirme

Kod örneği

Go uygulamanızı çalıştırma

Java ortamınızı ayarlama

Yeni Gradle projesi oluşturma

Depolama kapsayıcısında tüm belgeleri çevirme

Kod örneği

Java uygulamanızı derleme ve çalıştırma

Node.js ortamınızı ayarlama

Depolama kapsayıcısında tüm belgeleri çevirme

Kod örneği

JavaScript uygulamanızı çalıştırma

Python projenizi ayarlama

Depolama kapsayıcısında tüm belgeleri çevirme

Kod örneği

Python uygulamanızı çalıştırma

Programlama ortamınızı ayarlama

Belgeleri çevirme (POST İsteği)

POST isteğini derleme ve çalıştırma

Sonraki adımlar

Ek kaynaklar