Requisitos previos

• Acceso a la consola de Google Cloud.
• Ambiente SoftExpert Suite alojado en la nube.
• Acceso al menú Configuración > Centro de integraciones (COP010).
• Permiso ''Funcionalidades de IA'' habilitado en Configuración > Grupo de acceso (CM011) > Otros permisos > Funcionalidades de IA.

Presentación

La API Google v2 se utiliza para la traducción automática de texto, mientras que la v3 se utiliza para la traducción automática de texto y de archivos.

Para configurar la API de integración Google v2 o v3, es necesario generar previamente las credenciales en la consola de Google Cloud.

La consola de Google Cloud no requiere instalación ni configuración previa y se puede acceder a ella directamente por medio de un navegador.

Este artículo presenta el paso a paso para generar las credenciales necesarias, tanto para la versión Google v2 como para la Google v3.

Generar credencial para API Google v2 (traducción de textos)

1. Acceda a la consola de Google Cloud por medio del navegador.

2. En la pantalla inicial, haga clic en Menú de navegación > API y Servicios > Credenciales.

3. Haga clic en Crear credenciales y seleccione la opción Clave de API.

4. Informe los datos necesarios para la creación de la clave:

• Nombre: use un nombre exclusivo para identificar su clave de API.
• Autenticar llamadas de API por una cuenta de servicio: seleccione esta opción en caso de que desee autenticar las llamadas de API por la cuenta de servicio y vincule una cuenta.
• Restricciones de la aplicación/API: seleccione un tipo de aplicación o API específicos para restringir el acceso.

5. Haga clic en Crear.

6. La clave se generará; cópiela y almacénela de forma segura, pues se utilizará posteriormente.

7. Acceda al componente Configuración > Centro de integraciones (COP010) > API de integración.

8. Haga clic en el botón para incluir una nueva API del tipo Google v2.

9. Informe el título y, en el campo API Key, informe la clave generada en la consola de Google Cloud.

10. Haga clic en el botón .

11. Aún en el menú Centro de integraciones (COP010), pestaña Traducción, sección Texto, seleccione la API Google v2 registrada anteriormente.

12. Haga clic en el botón .

Generar credencial para API Google v3 (traducción de textos y archivos)

1. Acceda a la consola de Google Cloud por medio del navegador.

2. En la pantalla inicial, haga clic en Menú de navegación > API y Servicios > Credenciales.

3. Haga clic en Crear credenciales y seleccione la opción Cuenta de servicio.

4. En el paso 1, Crear cuenta de servicio, informe el nombre y el ID de la cuenta de servicio.

5. Haga clic en Crear y continuar.

6. En el paso 2, Permisos, seleccione la opción Usuario de la API Cloud Translation en el campo Seleccionar rol.

7. Haga clic en Continuar.

8. En el paso 3, Principales con acceso, informe los usuarios que tendrán el rol de usuario o de administrador de la cuenta de servicio.

9. Haga clic en Listo.

10. De vuelta a la pantalla inicial de la consola, en Cuentas de servicio, seleccione la cuenta creada y haga clic en Editar cuenta de servicio.

11. En la pantalla que se mostrará, acceda a la pestaña Claves, haga clic en Agregar claves y, a continuación, en Crear nueva clave.

12. En Tipo de clave, seleccione la opción JSON.

13. Haga clic en Crear. El archivo JSON se descargará automáticamente.

14. Acceda al componente Configuración > Centro de integraciones (COP010) > API de integración.

15. Haga clic en el botón para incluir una nueva API del tipo Google v3 y complete los campos con base en la información contenida en el archivo JSON descargado:

• E-mail: cliente_email.
• Identificador del proyecto: project_id.
• Clave privada: private_key.

16. Haga clic en el botón .

17. Aún en el menú Centro de integraciones (COP010), acceda a la pestaña Traducción.

18. En la sección Texto, seleccione la API Google v3 registrada anteriormente. En Archivos, también seleccione la misma API Google v3.

19. Haga clic en el botón .

Conclusión

Con las credenciales generadas, es posible continuar con la configuración de la API de integración para las opciones Google v2 y Google v3.