Method: projects.locations.batchTranslateDocument

Traduce un volume elevato di documenti in modalità batch asincrona. Questa funzione fornisce l'output in tempo reale durante l'elaborazione degli input. Se il chiamante annulla una richiesta, i risultati parziali (per un file di input, è tutto o niente) potrebbero comunque essere disponibili nella posizione di output specificata.

Questa chiamata viene restituita immediatamente e puoi utilizzare google.longrunning.Operation.name per eseguire il polling dello stato della chiamata.

Richiesta HTTP

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

Parametri del percorso

Parametri
parent

string

Obbligatorio. Posizione da cui effettuare una chiamata.

Formato: projects/{project-id}.

La località global non è supportata per la traduzione batch.

Possono essere utilizzati solo i glossari all'interno della stessa regione (con lo stesso ID località), altrimenti viene restituito un errore INVALID_ARGUMENT (400).

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

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

string

Obbligatorio. Il codice lingua ISO-639 del documento di input, se noto, ad esempio "en-US" o "sr-Latn". I codici lingua supportati sono elencati in Lingue supportate.
targetLanguageCodes[]

string

Obbligatorio. Il codice lingua ISO-639 da utilizzare per la traduzione del documento di input. Specifica fino a 10 codici di lingua qui.
inputConfigs[]

object (BatchDocumentInputConfig)

Obbligatorio. Configurazioni di input. Il numero totale di file corrispondenti deve essere inferiore o uguale a 100. La dimensione totale dei contenuti da tradurre deve essere inferiore o uguale a 100 milioni di punti di codice Unicode. I file devono utilizzare la codifica UTF-8.
outputConfig

object (BatchDocumentOutputConfig)

Obbligatorio. Configurazione dell'output. Se due configurazioni di input corrispondono allo stesso file (ovvero allo stesso percorso di input), non generiamo output per gli input duplicati.
glossaries

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

Facoltativo. Glossari da applicare. È indicizzato in base al codice della lingua di destinazione.
formatConversions

map (key: string, value: string)

Facoltativo. La mappa di conversione del formato file applicata a tutti i file di input. La chiave della mappa è il tipo MIME originale. Il valore della mappa è il tipo MIME di destinazione dei documenti tradotti.

La conversione dei formati file supportati include: - application/pdf in application/vnd.openxmlformats-officedocument.wordprocessingml.document

Se non viene specificato nulla, i file di output avranno lo stesso formato del file originale.
customizedAttribution

string

Facoltativo. Questo flag supporta l'attribuzione personalizzata dall'utente. Se non viene fornito, il valore predefinito è Machine Translated by Google. L'attribuzione personalizzata deve seguire le regole riportate all'indirizzo https://cloud.google.com/translate/attribution#attribution_and_logos
enableShadowRemovalNativePdf

boolean

Facoltativo. Se il valore è vero, utilizza il server di rimozione del testo per rimuovere il testo ombra sull'immagine di sfondo per la traduzione nativa dei PDF. La funzionalità di rimozione delle ombre può essere abilitata solo quando isTranslateNativePdfOnly: false && pdfNativeOnly: false
enableRotationCorrection

boolean

Facoltativo. Se è true, attiva la correzione della rotazione automatica in DVS.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

BatchDocumentInputConfig

Configurazione dell'input per la richiesta locations.batchTranslateDocument.

Rappresentazione 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.
}
Campi
Campo unione source. Specifica l'input. source può essere solo uno dei seguenti:
s3_source

object (s3Source)

Posizione del bucket S3 per l'input dell'origine. Può essere un singolo file o un carattere jolly.

Il tipo MIME del file viene determinato in base all'estensione. Il tipo MIME supportato include:

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

La dimensione massima del file supportata per .docx, .pptx e .xlsx è 100 MB. La dimensione massima del file supportata per .pdf è 1 GB e il limite massimo di pagine è 1000. La dimensione massima dei file supportata per tutti i documenti di input è 1 GB.

BatchDocumentOutputConfig

Configurazione dell'output per la richiesta locations.batchTranslateDocument.

Rappresentazione 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.
}
Campi
Campo unione destination. La destinazione dell'output. La directory di destinazione fornita deve esistere ed essere vuota. destination può essere solo uno dei seguenti:
s3_destination

object (s3Destination)

Bucket S3 di destinazione per i contenuti di output. Per ogni documento di input, generiamo al massimo 2 * n file di output. (n è il numero di codici lingua di destinazione in BatchTranslateDocumentRequest).

targetLanguageCode è fornito nella richiesta.