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 hacer una llamada regional.

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

Para llamadas internacionales, 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 usen modelos de AutoML o glosarios personalizados.

Los modelos y los glosarios deben estar en la misma región (tener el mismo location-id). De lo contrario, se devolverá un error INVALID_ARGUMENT (400).

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos que presentan la siguiente estructura:

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

string

Opcional. 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 indican en la página de idiomas admitidos. Si no se especifica el idioma de origen, la API intenta identificarlo automáticamente y lo devuelve en la respuesta. El idioma de origen debe especificarse si la solicitud contiene un glosario o un modelo personalizado.
targetLanguageCode

string

Obligatorio. Código de idioma ISO-639 que se va a usar para traducir el documento de entrada. Debe ser uno de los códigos de idioma que se indican en la sección Idiomas admitidos.
documentInputConfig

object (DocumentInputConfig)

Obligatorio. Configuraciones de entrada.
glossaryConfig

object (TranslateTextGlossaryConfig)

Opcional. Glosario que se va a aplicar. El glosario debe estar en la misma región (tener el mismo location-id) que el modelo. De lo contrario, se devolverá un error INVALID_ARGUMENT (400).

Para la autorización, se necesita el siguiente permiso de IAM en el recurso especificado glossaryConfig:

  • cloudtranslate.glossaries.docPredict

Cuerpo de la respuesta

Un mensaje de respuesta de un documento traducido.

Si la solicitud se realiza correctamente, el cuerpo de la respuesta proporciona datos con la siguiente estructura:

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

object (DocumentTranslation)

Documento traducido.
glossaryDocumentTranslation

object (DocumentTranslation)

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 de glosario.
glossaryConfig

object (TranslateTextGlossaryConfig)

El glossaryConfig usado en esta traducción.

Permisos de autorización

Debes disponer de uno de los siguientes permisos de OAuth:

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

DocumentInputConfig

Configuración de entrada de una solicitud de traducción de documentos.

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

string

Especifica el tipo MIME del documento de entrada.

Si no se especifica, se determinará mediante la extensión de archivo de los archivos proporcionados por S3Source. En el caso de los archivos proporcionados mediante contenido de bytes, se debe indicar el tipo MIME.

Los tipos MIME admitidos actualmente son los siguientes:

  • 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

Los formatos de archivo admitidos son:

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

string (bytes format)

Contenido del documento representado como un flujo de bytes.

Cadena codificada en base64.
S3Source

object (S3Source)

Ubicación de almacenamiento del contenido de entrada.

DocumentTranslation

Un mensaje de documento traducido.

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

string (bytes format)

Array de documentos traducidos. Por ahora, se espera que sea de tamaño 1. Es posible que en el futuro produzcamos varios documentos traducidos para otros tipos de formatos de archivo.

Cadena codificada en base64.
mimeType

string

El tipo MIME del documento traducido.
detectedLanguageCode

string

El idioma detectado del documento de entrada. Si el usuario no ha proporcionado el idioma de origen del documento de entrada, este campo tendrá el código de idioma detectado automáticamente. Si se ha proporcionado el idioma de origen, no se detectará automáticamente el idioma y este campo estará vacío.