Method: projects.locations.translateDocument

Traduce i documenti in modalità sincrona.

Richiesta HTTP

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

Parametri del percorso

Parametri
parent

string

Obbligatorio. Posizione per effettuare una chiamata regionale.

Formato: projects/{project-number-or-id}/locations/{location-id}.

Per le chiamate globali, utilizza projects/{project-number-or-id}/locations/global o projects/{project-number-or-id}.

Per le richieste che utilizzano modelli AutoML o glossari personalizzati è necessaria una località non globale.

I modelli e i glossari devono trovarsi nella stessa regione (avere 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,
  "targetLanguageCode": string,
  "documentInputConfig": {
    object (DocumentInputConfig)
  },
  "glossaryConfig": {
    object (TranslateTextGlossaryConfig)
  }
}
Campi
sourceLanguageCode

string

Facoltativo. 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 Supporto delle lingue. Se la lingua di origine non è specificata, l'API tenta di identificarla automaticamente e la restituisce nella risposta. La lingua di origine deve essere specificata se la richiesta contiene un glossario o un modello personalizzato.
targetLanguageCode

string

Obbligatorio. Il codice lingua ISO-639 da utilizzare per la traduzione del documento di input, impostato su uno dei codici lingua elencati in Supporto delle lingue.
documentInputConfig

object (DocumentInputConfig)

Obbligatorio. Configurazioni di input.
glossaryConfig

object (TranslateTextGlossaryConfig)

Facoltativo. Glossario da applicare. Il glossario deve trovarsi nella stessa regione (avere lo stesso ID località) del modello, altrimenti viene restituito un errore INVALID_ARGUMENT (400).

L'autorizzazione richiede il seguente permesso IAM per la risorsa specificata glossaryConfig:

  • cloudtranslate.glossaries.docPredict

Corpo della risposta

Un messaggio di risposta del documento tradotto.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "documentTranslation": {
    object (DocumentTranslation)
  },
  "glossaryDocumentTranslation": {
    object (DocumentTranslation)
  },
  "glossaryConfig": {
    object (TranslateTextGlossaryConfig)
  }
}
Campi
documentTranslation

object (DocumentTranslation)

Documento tradotto.
glossaryDocumentTranslation

object (DocumentTranslation)

L'output di traduzione del documento se nella richiesta viene fornito un glossario. Può essere uguale a [TranslateDocumentResponse.document_translation] se non vengono applicati termini del glossario.
glossaryConfig

object (TranslateTextGlossaryConfig)

Il glossaryConfig utilizzato per questa traduzione.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

DocumentInputConfig

Una configurazione di input della richiesta di traduzione di documenti.

Rappresentazione JSON 
{
  "mimeType": string,
  "content": string,
  "S3Source": {
    object (S3Source)
  }
}
Campi
mimeType

string

Specifica il tipo MIME del documento di input.

Se non specificato, verrà determinato utilizzando l'estensione del file per i file forniti da S3Source. Per un file fornito tramite contenuti in byte, è necessario fornire il tipo MIME.

I tipi MIME attualmente supportati sono:

  • application/pdf
  • application/msword
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • application/vnd.ms-powerpoint
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.ms-excel
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

I formati di file supportati sono:

  • PDF
  • DOC
  • DOCX
  • PPT
  • PPTX
  • XLS
  • XLSX
content

string (bytes format)

I contenuti del documento rappresentati come flusso di byte.

Una stringa con codifica in base64.
S3Source

object (S3Source)

La posizione di archiviazione dei contenuti di input.

DocumentTranslation

Un messaggio di documento tradotto.

Rappresentazione JSON 
{
  "byteStreamOutputs": [
    string
  ],
  "mimeType": string,
  "detectedLanguageCode": string
}
Campi
byteStreamOutputs[]

string (bytes format)

L'array di documenti tradotti. Al momento è previsto che le dimensioni siano pari a 1. In futuro potremmo produrre più documenti tradotti per altri tipi di formati di file.

Una stringa con codifica in base64.
mimeType

string

Il tipo MIME del documento tradotto.
detectedLanguageCode

string

La lingua rilevata per il documento di input. Se l'utente non ha fornito la lingua di origine per il documento di input, questo campo conterrà il codice lingua rilevato automaticamente. Se è stata passata la lingua di origine, non viene eseguito il rilevamento automatico della lingua e questo campo è vuoto.