Tarea Translate - Document

La tarea Translate - Document te permite traducir un solo archivo de documento en tiempo real (de forma síncrona) con Cloud Translation. Puedes traducir directamente documentos con formato, como PDF y DOCX, y conservar su formato y diseño originales. Si deseas obtener información sobre los formatos de archivo compatibles para la traducción de documentos, consulta Formatos de archivo compatibles.

Cloud Translation es un servicio de Google Cloud que te permite traducir texto para más de 100 pares de idiomas con la capacidad de detectar idiomas automáticamente. Para obtener una lista de los idiomas compatibles, consulta Idiomas compatibles.

Antes de comenzar

Asegúrate de realizar las siguientes tareas en tu proyecto de Google Cloud antes de configurar la tarea Translate - Document:

  1. Habilita la API de Cloud Translation (translate.googleapis.com).

    Habilita la API de Cloud Translation

  2. Crea un perfil de autenticación. Apigee Integration usa un perfil de autenticación a fin de conectarse a un extremo de autenticación para la tarea Translate - Document.

    Para obtener información sobre cómo otorgar roles o permisos adicionales a una cuenta de servicio, consulta Cómo otorgar, cambiar y revocar el acceso a los recursos.

Configura la tarea Translate - Document

  1. En la IU de Apigee, selecciona tu organización de Apigee.
  2. Haz clic en Desarrollar > Integraciones.
  3. Selecciona una integración existente o crea una nueva haciendo clic en Crear integración.

    Si creas una integración nueva, haz lo siguiente:

    1. Ingresa un nombre y una descripción en el diálogo Crear integración.
    2. En la lista de regiones compatibles, selecciona Región para la integración.
    3. Haz clic en Crear.

    Esto abrirá la integración en la página del diseñador de integración.

  4. En la barra de navegación Diseñador de integración, haz clic en +Agregar una tarea o un activador > Tareas para ver la lista de tareas disponibles.
  5. Haz clic y coloca el elemento Translate - Document en el diseñador de integración.
  6. Haz clic en el elemento Translate - Document en el diseñador para ver el panel de configuración de tareas Translate - Document.
  7. Ve a Autenticación y selecciona un perfil de autenticación existente que desees usar.

    Opcional. Si no creaste un perfil de autenticación antes de configurar la tarea, haz clic en + Nuevo perfil de autenticación y sigue los pasos que se mencionan en Crea un perfil de autenticación nuevo.

  8. Ve a Entrada de tarea y configura los campos de entrada que se muestran con la siguiente tabla de parámetros de entrada de la tarea.

    Los cambios en los campos de entrada se guardan de forma automática.

Parámetros de entrada de la tarea

En la siguiente tabla, se describen los parámetros de entrada de la tarea Translate - Document:

Propiedad Tipo de datos Descripción
Región String Región donde deseas ejecutar la operación de traducción. Por ejemplo, us-central1.
ProjectsId String Tu ID del proyecto de Google Cloud.
Solicitud JSON Consulta la estructura de solicitud JSON. Debes especificar el campo mimeType del JSON de la solicitud para las traducciones de documentos intercalados.

Resultado de la tarea

La tarea Translate - Document muestra el documento traducido, similar al siguiente resultado de muestra: 

{
    "documentTranslation": {
        "byteStreamOutputs": ["BYTE_STREAM"],
        "mimeType": "MIME_TYPE"
    },
    "model": "projects/[PROJECT_NUMBER]/locations/[LOCATION]/models/general/nmt"
}

Formatos de archivo compatibles

Cloud Translation admite los siguientes tipos de archivos de entrada y sus tipos de archivos de salida asociados. Para obtener información sobre los límites de tamaño de los archivos de los documentos, consulta Límites de tamaño de los archivos de documentos.

Entradas Tipo de documento MIME Salida
DOC application/msword DOC, DOCX
DOCX application/vnd.openxmlformats-officedocument.wordprocessingml.document DOCX
PDF application/pdf PDF, DOCX
PPT application/vnd.ms-powerpoint PPT, PPTX
PPTX application/vnd.openxmlformats-officedocument.presentationml.presentation PPTX
XLS application/vnd.ms-excel XLS, XLSX
XLSX application/vnd.openxmlformats-officedocument.spreadsheetml.sheet XLSX

Límites de tamaño de archivo de documentos

Tipo de archivo Límites de tamaño
PDF Hasta 20 MB
PDF nativo

(el campo isTranslateNativePdfOnly debe configurarse como true)

Hasta 20 MB con un límite de 300 páginas
PDF escaneado Hasta 20 MB con un límite de 20 páginas
Otros tipos de archivos Hasta 20 MB sin límite de páginas

Estrategia de manejo de errores

Una estrategia de manejo de errores de una tarea específica la acción que se debe realizar si la tarea falla debido a un error temporal. Para obtener información sobre cómo usar una estrategia de manejo de errores y conocer los diferentes tipos de estrategias de manejo de errores, consulta Estrategias de manejo de errores.

¿Qué sigue?

  1. Agrega perímetros y condiciones perimetrales.
  2. Prueba y publica tu integración.
  3. Configura un activador.
  4. Agrega una tarea de asignación de datos.
  5. Consulta todas las tareas para los servicios de Google Cloud.