Çeviriyi Başlat

Belge çevirisi hizmetiyle bir çeviri isteği başlatmak için bu API 'yi kullanın. Her istek birden çok belge içerebilir ve her belge için bir kaynak ve hedef kapsayıcı içermelidir.

Klasörleri filtrelemek için önek ve sonek filtresi (sağlanırsa) kullanılır. Önek, kapsayıcı adından sonra alt yol için uygulanır.

Işları/çeviri belleği, isteğe dahil edilebilir ve belge çevrildiğinde hizmet tarafından uygulanır.

Sözlük, çeviri sırasında geçersiz veya ulaşılamaz durumdaysa, belge durumunda bir hata gösterilir. Hedefte aynı ada sahip bir dosya zaten varsa, iş başarısız olur. Her hedef dilin targetUrl 'Si benzersiz olmalıdır.

İstek URL’si

Şu kişiye bir POST istek gönder:

POST https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.0/batches

Özel etki alanı adınızıbulmayı öğrenin.

İstek üst bilgileri

İstek üst bilgileri:

İstek gövdesi: Batch gönderim Isteği

Girişler

Giriş toplu işlem çevirisi isteği için tanım.

girişler. kaynak

Giriş belgelerinin kaynağı.

girişler. storageType

giriş belgelerinin kaynak dizesinin Depolama türü.

girişler. Target

Tamamlanmış çevrilmiş belgelerin hedefi.

Örnek istek

Aşağıda toplu iş isteklerinin örnekleri verilmiştir.

Kapsayıcıda tüm belgeleri çeviri

{
    "inputs": [
        {
            "source": {
                "sourceUrl": "https://my.blob.core.windows.net/source-en?sv=2019-12-12&st=2021-03-05T17%3A45%3A25Z&se=2021-03-13T17%3A45%3A00Z&sr=c&sp=rl&sig=SDRPMjE4nfrH3csmKLILkT%2Fv3e0Q6SWpssuuQl1NmfM%3D"
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.windows.net/target-fr?sv=2019-12-12&st=2021-03-05T17%3A49%3A02Z&se=2021-03-13T17%3A49%3A00Z&sr=c&sp=wdl&sig=Sq%2BYdNbhgbq4hLT0o1UUOsTnQJFU590sWYo4BOhhQhs%3D",
                    "language": "fr"
                }
            ]
        }
    ]
}

Bir kapsayıcıda sözlükleri uygulayarak tüm belgeleri çevirin

Belirli bir blob/belge için (& için değil) SAS belirteci için sözlük URL'si oluşturduğunuzdan emin olun

{
    "inputs": [
        {
            "source": {
                "sourceUrl": "https://my.blob.core.windows.net/source-en?sv=2019-12-12&st=2021-03-05T17%3A45%3A25Z&se=2021-03-13T17%3A45%3A00Z&sr=c&sp=rl&sig=SDRPMjE4nfrH3csmKLILkT%2Fv3e0Q6SWpssuuQl1NmfM%3D"
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.windows.net/target-fr?sv=2019-12-12&st=2021-03-05T17%3A49%3A02Z&se=2021-03-13T17%3A49%3A00Z&sr=c&sp=wdl&sig=Sq%2BYdNbhgbq4hLT0o1UUOsTnQJFU590sWYo4BOhhQhs%3D",
                    "language": "fr",
                    "glossaries": [
                        {
                            "glossaryUrl": "https://my.blob.core.windows.net/glossaries/en-fr.xlf?sv=2019-12-12&st=2021-03-05T17%3A45%3A25Z&se=2021-03-13T17%3A45%3A00Z&sr=c&sp=rl&sig=BsciG3NWoOoRjOYesTaUmxlXzyjsX4AgVkt2AsxJ9to%3D",
                            "format": "xliff",
                            "version": "1.2"
                        }
                    ]

                }
            ]
        }
    ]
}

Kapsayıcıda belirli bir klasörü çeviri

Sas belirteci hala kapsayıcı için olsa da, filtrede klasör adını (büyük/küçük harfe duyarlı) ön ek olarak belirttiğinizden emin olun.

{
    "inputs": [
        {
            "source": {
                "sourceUrl": "https://my.blob.core.windows.net/source-en?sv=2019-12-12&st=2021-03-05T17%3A45%3A25Z&se=2021-03-13T17%3A45%3A00Z&sr=c&sp=rl&sig=SDRPMjE4nfrH3csmKLILkT%2Fv3e0Q6SWpssuuQl1NmfM%3D",
                "filter": {
                    "prefix": "MyFolder/"
                }
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.windows.net/target-fr?sv=2019-12-12&st=2021-03-05T17%3A49%3A02Z&se=2021-03-13T17%3A49%3A00Z&sr=c&sp=wdl&sig=Sq%2BYdNbhgbq4hLT0o1UUOsTnQJFU590sWYo4BOhhQhs%3D",
                    "language": "fr"
                }
            ]
        }
    ]
}

Kapsayıcıda belirli bir belgeyi çeviri

• "storageType": "File" belirttiğinizden emin olun
• Belirli bir blob/belge & (kapsayıcı için değil) sas belirteci için kaynak URL'yi oluşturduğunuzdan emin olun
• HEDEF URL'nin bir parçası olarak hedef dosya adını belirttiğinizden emin olun, ancak SAS belirteci hala kapsayıcıya yöneliktir.
• Aşağıdaki örnek istekte iki hedef dile çevrilen tek bir belge gösterilmiştir

{
    "inputs": [
        {
            "storageType": "File",
            "source": {
                "sourceUrl": "https://my.blob.core.windows.net/source-en/source-english.docx?sv=2019-12-12&st=2021-01-26T18%3A30%3A20Z&se=2021-02-05T18%3A30%3A00Z&sr=c&sp=rl&sig=d7PZKyQsIeE6xb%2B1M4Yb56I%2FEEKoNIF65D%2Fs0IFsYcE%3D"
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.windows.net/target/try/Target-Spanish.docx?sv=2019-12-12&st=2021-01-26T18%3A31%3A11Z&se=2021-02-05T18%3A31%3A00Z&sr=c&sp=wl&sig=AgddSzXLXwHKpGHr7wALt2DGQJHCzNFF%2F3L94JHAWZM%3D",
                    "language": "es"
                },
                {
                    "targetUrl": "https://my.blob.core.windows.net/target/try/Target-German.docx?sv=2019-12-12&st=2021-01-26T18%3A31%3A11Z&se=2021-02-05T18%3A31%3A00Z&sr=c&sp=wl&sig=AgddSzXLXwHKpGHr7wALt2DGQJHCzNFF%2F3L94JHAWZM%3D",
                    "language": "de"
                }
            ]
        }
    ]
}

Yanıt durum kodları

Aşağıdakiler, bir isteğin döndürtt olduğu olası HTTP durum kodlarıdır.

Hata yanıtı

Örnekler

Örnek başarılı yanıt

Başarılı bir yanıtta aşağıdaki bilgiler döndürülür.

İş kimliğini POST yönteminin yanıt Üst Bilgisinde ve URL Operation-Location bulabilirsiniz. URL'nin son parametresi, işlem iş kimliğidir ("/operation/" dizesini takip eden dize).

Operation-Location: https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.0/operation/0FA2822F-4C2A-4317-9C20-658C801E0E55

Örnek hata yanıtı

{
  "error": {
    "code": "ServiceUnavailable",
    "message": "Service is temporary unavailable",
    "innerError": {
      "code": "ServiceTemporaryUnavailable",
      "message": "Service is currently unavailable.  Please try again later"
    }
  }
}

Sonraki adımlar

Belge Çevirisi ve istemci kitaplığını kullanma hakkında daha fazla bilgi edinmek için hızlı başlangıç sayfamızı izleyin.