Method: projects.locations.batchTranslateDocument

Traduce un gran volumen de documentos en modo de lote asíncrono. Esta función proporciona resultados en tiempo real a medida que se procesan las entradas. Si la persona que llama cancela una solicitud, los resultados parciales (en el caso de un archivo de entrada, se trata de todo o nada) pueden seguir estando disponibles en la ubicación de salida especificada.

Esta llamada se devuelve inmediatamente 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 desde la que se va a hacer la llamada. Formato: projects/{project-id}. La ubicación global no se admite en la traducción por lotes. Solo se pueden usar glosarios de la misma región (con el mismo location-id). De lo contrario, se devuelve 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, "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. 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. El código de idioma ISO-639 que se usará para traducir el documento de entrada. Especifica hasta 10 códigos de idioma.
inputConfigs[]	object (BatchDocumentInputConfig) Obligatorio. Configuraciones de entrada. El número total de archivos coincidentes debe ser igual o inferior a 100. El tamaño total del contenido que se va a traducir debe ser de 100 millones de puntos de código Unicode como máximo. Los archivos deben usar la codificación UTF-8.
outputConfig	object (BatchDocumentOutputConfig) Obligatorio. Configuración de salida. Si dos configuraciones de entrada coinciden con el mismo archivo (es decir, tienen la misma ruta de entrada), no generamos una salida para las entradas duplicadas.
glossaries	map (key: string, value: object (TranslateTextGlossaryConfig)) Opcional. Glosarios que se van a aplicar. Se define mediante el código de idioma de destino.
formatConversions	map (key: string, value: string) Opcional. La asignación de conversión de formato de archivo que se aplica a todos los archivos de entrada. La clave del mapa es el tipo MIME original. El valor del mapa es el tipo MIME de destino de los documentos traducidos. Se admite la conversión de los siguientes formatos de archivo: - 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 se usa para admitir 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 se le asigna el valor "true", se usará el servidor de eliminación de texto para quitar el texto de sombra de la imagen de fondo en 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 true, habilita la corrección de rotación automática en DVS.

Cuerpo de la respuesta

Si la solicitud se hace correctamente, en el cuerpo de la respuesta se incluye una instancia de Operation.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

BatchDocumentInputConfig

Configuración de entrada para la solicitud 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 solo puede ser una de las siguientes cosas:
s3_source	object (s3Source) Ubicación del bucket de S3 de la entrada de origen. Puede ser un solo archivo o un comodín. El tipo MIME del archivo se determina en función de la extensión. Tipos MIME admitidos: 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 1000. El tamaño máximo de archivo admitido para todos los documentos de entrada es de 1 GB.

BatchDocumentOutputConfig

Configuración de salida de la solicitud 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. El destino de la salida. El directorio de destino proporcionado debe existir y estar vacío. destination solo puede ser una de las siguientes cosas:
s3_destination	object (s3Destination) Segmento de S3 de destino del contenido de salida. Por cada documento de entrada, generamos como máximo 2 * n archivos de salida. (n es el número de códigos de idioma de destino en BatchTranslateDocumentRequest). targetLanguageCode se proporciona en la solicitud.