Method: projects.locations.batchTranslateDocument

Traduce un gran volumen de documentos en modo por lotes asíncrono. Esta función proporciona resultados en tiempo real a medida que se procesan las entradas. Si el llamador cancela una solicitud, es posible que los resultados parciales (para un archivo de entrada, son todos o ninguno) sigan disponibles en la ubicación de salida especificada.

Esta llamada se devuelve de inmediato, y puedes usar google.longrunning.Operation.name para sondear el estado de la llamada.

Solicitud HTTP

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

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Ubicación para hacer una llamada.

Formato: projects/{project-id}.

La ubicación global no es compatible con la traducción por lotes.

Solo se pueden usar los glosarios que se encuentren en la misma región (que tengan el mismo ID de ubicación). De lo contrario, se devolverá 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,
  "targetLanguageCodes": [
    string
  ],
  "inputConfigs": [
    {
      object (BatchDocumentInputConfig)
    }
  ],
  "outputConfig": {
    object (BatchDocumentOutputConfig)
  },
  "glossaries": {
    string: {
      object (TranslateTextGlossaryConfig)
    },
    ...
  },
  "formatConversions": {
    string: string,
    ...
  },
  "customizedAttribution": string,
  "enableShadowRemovalNativePdf": boolean,
  "enableRotationCorrection": boolean
}
Campos
sourceLanguageCode

string

Obligatorio. 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 indican en Idiomas admitidos.
targetLanguageCodes[]

string

Obligatorio. Es el código de idioma ISO-639 que se usará para traducir el documento de entrada. Aquí puedes especificar hasta 10 códigos de idioma.
inputConfigs[]

object (BatchDocumentInputConfig)

Obligatorio. Configuraciones de entrada La cantidad total de archivos coincidentes debe ser menor o igual a 100. El tamaño total del contenido que se traducirá debe ser menor o igual que 100 millones de puntos de código Unicode. Los archivos deben usar la codificación UTF-8.
outputConfig

object (BatchDocumentOutputConfig)

Obligatorio. Es la configuración de salida. Si 2 parámetros de configuración de entrada coinciden con el mismo archivo (es decir, la misma ruta de entrada), no generamos resultados para las entradas duplicadas.
glossaries

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

Opcional. Son los glosarios que se aplicarán. La clave es el código de idioma de destino.
formatConversions

map (key: string, value: string)

Opcional. Es el mapa de conversión de formato de archivo que se aplica a todos los archivos de entrada. La clave del mapa es el valor de mimeType original. El valor del mapa es el mimeType de destino de los documentos traducidos.

La conversión de formatos de archivo admitida incluye lo siguiente: - application/pdf a application/vnd.openxmlformats-officedocument.wordprocessingml.document

Si no se especifica nada, los archivos de salida tendrán el mismo formato que el archivo original.
customizedAttribution

string

Opcional. Esta marca admite la atribución personalizada por el usuario. Si no se proporciona, el valor predeterminado es Machine Translated by Google. La atribución personalizada debe seguir las reglas que se indican en https://cloud.google.com/translate/attribution#attribution_and_logos.
enableShadowRemovalNativePdf

boolean

Opcional. Si es verdadero, usa el servidor de eliminación de texto para quitar el texto de sombra en la imagen de fondo para la traducción nativa de PDF. La función de eliminación de sombras solo se puede habilitar cuando isTranslateNativePdfOnly: false && pdfNativeOnly: false
enableRotationCorrection

boolean

Opcional. Si es verdadero, habilita la corrección de rotación automática en el DVS.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

BatchDocumentInputConfig

Es la configuración de entrada para la solicitud de locations.batchTranslateDocument.

Representación 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.
}
Campos
Campo de unión source. Especifica la entrada. source puede ser solo uno de los siguientes:
s3_source

object (s3Source)

Ubicación del bucket de S3 para la entrada de origen. Puede ser un solo archivo o un comodín.

El tipo de MIME del archivo se determina según la extensión. Los tipos de MIME admitidos incluyen los siguientes:

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

El tamaño máximo de archivo admitido para .docx, .pptx y .xlsx es de 100 MB. El tamaño máximo de archivo admitido para .pdf es de 1 GB y el límite máximo de páginas es de 1,000. El tamaño máximo de archivo admitido para todos los documentos de entrada es de 1 GB.

BatchDocumentOutputConfig

Es la configuración de salida para la solicitud de locations.batchTranslateDocument.

Representación 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.
}
Campos
Campo de unión destination. Es el destino de la salida. El directorio de destino proporcionado debe existir y estar vacío. destination puede ser solo uno de los siguientes:
s3_destination

object (s3Destination)

Bucket de S3 de destino para el contenido de salida. Para cada documento de entrada, generamos como máximo 2 * n archivos de salida. (n es la cantidad de códigos de idioma de destino en BatchTranslateDocumentRequest).

targetLanguageCode se proporciona en la solicitud.