Method: projects.locations.batchTranslateDocument

Menerjemahkan dokumen dalam jumlah besar dalam mode batch asinkron. Fungsi ini memberikan output real-time saat input diproses. Jika pemanggil membatalkan permintaan, hasil parsial (untuk file input, semuanya atau tidak sama sekali) mungkin masih tersedia di lokasi output yang ditentukan.

Panggilan ini akan segera ditampilkan dan Anda dapat menggunakan google.longrunning.Operation.name untuk melakukan polling status panggilan.

Permintaan HTTP

POST https://{TRANSLATION_GDC_ENDPOINT}/v3/{parent}:batchTranslateDocument

Parameter jalur

Parameter
parent

string

Wajib. Lokasi untuk melakukan panggilan.

Format projects/{project-id}.

Lokasi global tidak didukung untuk terjemahan batch.

Hanya glosarium dalam region yang sama (memiliki location-id yang sama) yang dapat digunakan. Jika tidak, error INVALID_ARGUMENT (400) akan ditampilkan.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "sourceLanguageCode": string,
  "targetLanguageCodes": [
    string
  ],
  "inputConfigs": [
    {
      object (BatchDocumentInputConfig)
    }
  ],
  "outputConfig": {
    object (BatchDocumentOutputConfig)
  },
  "glossaries": {
    string: {
      object (TranslateTextGlossaryConfig)
    },
    ...
  },
  "formatConversions": {
    string: string,
    ...
  },
  "customizedAttribution": string,
  "enableShadowRemovalNativePdf": boolean,
  "enableRotationCorrection": boolean
}
Kolom
sourceLanguageCode

string

Wajib. Kode bahasa ISO-639 dari dokumen input jika diketahui, misalnya, "en-US" atau "sr-Latn". Kode bahasa yang didukung tercantum dalam Bahasa yang didukung.
targetLanguageCodes[]

string

Wajib. Kode bahasa ISO-639 yang akan digunakan untuk terjemahan dokumen input. Tentukan hingga 10 kode bahasa di sini.
inputConfigs[]

object (BatchDocumentInputConfig)

Wajib. Konfigurasi input. Jumlah total file yang cocok harus <= 100. Total ukuran konten yang akan diterjemahkan harus <= 100 juta codepoint Unicode. File harus menggunakan encoding UTF-8.
outputConfig

object (BatchDocumentOutputConfig)

Wajib. Konfigurasi output. Jika 2 konfigurasi input cocok dengan file yang sama (yaitu, jalur input yang sama), kami tidak akan menghasilkan output untuk input duplikat.
glossaries

map (key: string, value: object (TranslateTextGlossaryConfig))

Opsional. Glosarium yang akan diterapkan. Ini dikunci oleh kode bahasa target.
formatConversions

map (key: string, value: string)

Opsional. Peta konversi format file yang diterapkan ke semua file input. Kunci peta adalah mimeType asli. Nilai peta adalah target mimeType dokumen yang diterjemahkan.

Konversi format file yang didukung mencakup: - application/pdf ke application/vnd.openxmlformats-officedocument.wordprocessingml.document

Jika tidak ada yang ditentukan, file output akan memiliki format yang sama dengan file asli.
customizedAttribution

string

Opsional. Flag ini digunakan untuk mendukung atribusi yang disesuaikan pengguna. Jika tidak diberikan, defaultnya adalah Machine Translated by Google. Atribusi yang disesuaikan harus mengikuti aturan di https://cloud.google.com/translate/attribution#attribution_and_logos
enableShadowRemovalNativePdf

boolean

Opsional. Jika benar, gunakan server penghapusan teks untuk menghapus teks bayangan pada gambar latar belakang untuk terjemahan PDF native. Fitur penghapusan bayangan hanya dapat diaktifkan jika isTranslateNativePdfOnly: false && pdfNativeOnly: false
enableRotationCorrection

boolean

Opsional. Jika benar (true), aktifkan koreksi rotasi otomatis di DVS.

Isi respons

Jika berhasil, isi respons akan berisi instance Operation.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform

BatchDocumentInputConfig

Konfigurasi input untuk permintaan locations.batchTranslateDocument.

Representasi JSON 
{

  // Union field source can be only one of the following:
  "s3_source": {
    object (s3Source)
  }
  // End of list of possible types for union field source.
}
Kolom
Kolom union source. Tentukan input. source hanya ada berupa salah satu diantara berikut:
s3_source

object (s3Source)

Lokasi bucket S3 untuk input sumber. Ini dapat berupa satu file atau karakter pengganti.

Jenis MIME file ditentukan berdasarkan ekstensi. Jenis MIME yang didukung meliputi:

  • pdf: application/pdf
  • docx: application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • pptx: application/vnd.openxmlformats-officedocument.presentationml.presentation
  • xlsx: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Ukuran file maksimum yang didukung untuk .docx, .pptx, dan .xlsx adalah 100 MB. Ukuran file maksimum yang didukung untuk .pdf adalah 1 GB dan batas halaman maksimum adalah 1.000 halaman. Ukuran file maksimum yang didukung untuk semua dokumen input adalah 1 GB.

BatchDocumentOutputConfig

Konfigurasi output untuk permintaan locations.batchTranslateDocument.

Representasi JSON 
{

  // Union field destination can be only one of the following:
  "s3_destination": {
    object (s3Destination)
  }
  // End of list of possible types for union field destination.
}
Kolom
Kolom union destination. Tujuan output. Direktori tujuan yang diberikan harus ada dan kosong. destination hanya ada berupa salah satu diantara berikut:
s3_destination

object (s3Destination)

Tujuan bucket S3 untuk konten output. Untuk setiap dokumen input, kami menghasilkan paling banyak 2 * n file output. (n adalah jumlah kode bahasa target dalam BatchTranslateDocumentRequest).

targetLanguageCode diberikan dalam permintaan.