Method: projects.locations.translateDocument

Traduce documentos en modo síncrono.

Solicitud HTTP

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

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Ubicación para realizar una llamada regional.

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

Para las llamadas globales, usa projects/{project-number-or-id}/locations/global o projects/{project-number-or-id}.

Se requiere una ubicación no global para las solicitudes que usan modelos de AutoML o glosarios personalizados.

Los modelos y los glosarios deben estar en la misma región (tener el mismo ID de ubicación). De lo contrario, se muestra un error INVALID_ARGUMENT (400).

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "sourceLanguageCode": string,
  "targetLanguageCode": string,
  "documentInputConfig": {
    object (DocumentInputConfig)
  },
  "glossaryConfig": {
    object (TranslateTextGlossaryConfig)
  }
}
Campos
sourceLanguageCode

string

Es opcional. Es el código de idioma ISO-639 del documento de entrada si se conoce, por ejemplo, "en-US" o "sr-Latn". Los códigos de idioma admitidos se enumeran en Compatibilidad con idiomas. Si no se especifica el idioma de origen, la API intenta identificarlo automáticamente y lo muestra en la respuesta. Se debe especificar el idioma de origen si la solicitud contiene un glosario o un modelo personalizado.
targetLanguageCode

string

Obligatorio. Es el código de idioma ISO-639 que se usará para traducir el documento de entrada. Se establece en uno de los códigos de idioma que se enumeran en Compatibilidad con idiomas.
documentInputConfig

object (DocumentInputConfig)

Obligatorio. Son las configuraciones de entrada.
glossaryConfig

object (TranslateTextGlossaryConfig)

Es opcional. Es el glosario que se aplicará. El glosario debe estar en la misma región (tener el mismo ID de ubicación) que el modelo. De lo contrario, se muestra un error INVALID_ARGUMENT (400).

La autorización requiere el siguiente permiso de IAM en el recurso especificado glossaryConfig:

  • cloudtranslate.glossaries.docPredict

Cuerpo de la respuesta

Es un mensaje de respuesta de documento traducido.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "documentTranslation": {
    object (DocumentTranslation)
  },
  "glossaryDocumentTranslation": {
    object (DocumentTranslation)
  },
  "glossaryConfig": {
    object (TranslateTextGlossaryConfig)
  }
}
Campos
documentTranslation

object (DocumentTranslation)

Es el documento traducido.
glossaryDocumentTranslation

object (DocumentTranslation)

Es el resultado de la traducción del documento si se proporciona un glosario en la solicitud. Puede ser el mismo que [TranslateDocumentResponse.document_translation] si no se aplican términos del glosario.
glossaryConfig

object (TranslateTextGlossaryConfig)

Es el glossaryConfig que se usó para esta traducción.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

DocumentInputConfig

Es una configuración de entrada de solicitud de traducción de documentos.

Representación JSON 
{
  "mimeType": string,
  "content": string,
  "S3Source": {
    object (S3Source)
  }
}
Campos
mimeType

string

Especifica el mimeType del documento de entrada.

Si no se especifica, se determinará con la extensión de archivo para los archivos proporcionados por S3Source. Para un archivo proporcionado a través del contenido de bytes, se debe proporcionar el mimeType.

Actualmente, se admiten los siguientes tipos de MIME:

  • 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

Supported file formats are:

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

string (bytes format)

Es el contenido del documento representado como un flujo de bytes.

String codificada en base64.
S3Source

object (S3Source)

Es la ubicación de almacenamiento del contenido de entrada.

DocumentTranslation

Es un mensaje de documento traducido.

Representación JSON 
{
  "byteStreamOutputs": [
    string
  ],
  "mimeType": string,
  "detectedLanguageCode": string
}
Campos
byteStreamOutputs[]

string (bytes format)

Es el array de documentos traducidos. Se espera que tenga un tamaño de 1 por ahora. Es posible que produzcamos varios documentos traducidos en el futuro para otros tipos de formatos de archivo.

String codificada en base64.
mimeType

string

Es el tipo MIME del documento traducido.
detectedLanguageCode

string

Es el idioma detectado para el documento de entrada. Si el usuario no proporcionó el idioma de origen para el documento de entrada, este campo tendrá el código de idioma detectado automáticamente. Si se pasó el idioma de origen, no se produce la detección automática del idioma y este campo está vacío.