Para acceder a un archivo Google Sheet es necesario crear una conexión con Google mediante la creación de una cuenta de servicio

Cuenta de Servicio

Una cuenta de servicio es un tipo especial de cuenta de Google que tiene como objetivo representar un usuario que necesita autenticarse para acceder data de Google API.

Siendo una cuenta separada, por defecto esta no tiene acceso a un SpreadSheet hasta que se le comparte uno, al igual que a una cuenta común.

Habilitar Acceso de API a un Proyecto

Primero hay que habilitar el acceso de API a un proyecto, esto se logra siguiendo estos pasos:

1. Dirígete a la Consola de Desarrolladores de Google y crea un nuevo proyecto (o selecciona el que ya tienes).

   

2. En el cuadro que dice "Buscar APIs y servicios", busca "API de Google Drive" y habilítala.
   

3. En el cuadro que dice "Buscar APIs y servicios", busca "API de Google Sheets" y habilítala.
   

Como obtener una Cuenta de Servicio

Para obtener una cuenta de servicio es necesario seguir los siguientes pasos:

1. Habilita el acceso a la API para un proyecto si aún no lo has hecho (paso anterior).

2. Ve a "APIs y servicios > Credenciales" y elige "Crear credenciales > Clave de cuenta de servicio".
   

3. Completa el formulario.
   

4. Haz clic en "Crear" y luego en "Hecho".

5. Presiona "Administrar cuentas de servicio" sobre Cuentas de servicio.
   

6. Haz clic en ⋮ cerca de la cuenta de servicio creada recientemente y selecciona "Administrar claves" y luego haz clic en "AGREGAR CLAVE > Crear una clave nueva".
   

   

7. Selecciona el tipo de clave JSON y haz clic en "Crear".

Al presionar "Crear", se descargarán las credenciales automáticamente:

{
    "type": "service_account",
    "project_id": "api-project-XXX",
    "private_key_id": "2cd … ba4",
    "private_key": "-----BEGIN PRIVATE KEY-----\nNrDyLw … jINQh/9\n-----END PRIVATE KEY-----\n",
    "client_email": "[email protected]",
    "client_id": "473 … hd.apps.googleusercontent.com",
    ...
}

Recuerda la ruta del archivo JSON de credenciales descargado

Habilitar permisos en tu hoja de cálculo

1. Ingresa a la hoja de cálculo en el que deseas hacer la integración con Fracttal.
2. Clic en compartir, y luego inserta correo electrónico que se generó en el paso anterior (client_email), con permisos de edición

Este paso lo puedes hacer en todas las hojas de cálculo que deseas que se comuniquen con Fracttal.

Crear la conexión en Fracttal

Después de tener las credenciales de la cuenta de servicio (información que se encuentra en el archivo JSON y haberle dado permisos de edición a la cuenta de servicio dentro de las hojas de cálculo, el paso siguiente es crear la conexión en Fracttal One :

1. En Fracttal One, ir a Configuracion/Catalogos auxiliares/Conexiones.
2. Crear una nueva conexión de tipo Google Sheet (Service Account).
3. Rellenar el formulario con los datos de las credenciales descargadas (es importante copiarlas tal y como aparecen en el archivo descargado, y sin las comillas).
4. Guardar

Una vez hecho, esto ya esta todo listo para comenzar a crear un flujo de integración dentro de Fracttal HUB, donde la comunicación será entre una Hoja de Cálculo y Fracttal One.

Crear el flujo en Fracttal HUB

Ya con la conexión creada solo queda configurar esta en Fracttal HUB siguiendo estos pasos:

1. En Fracttal One, ir a Fracttal HUB.
   
2. Crea un nuevo flujo.
   
3. En la fuente, selecciona el módulo Google Sheet.
   
4. De acuerdo a los siguientes campos, completa la información requerida:

5. En el destino, selecciona la acción a realizar.
6. Mapea los campos de el Spreadsheet con los campos de Fracttal.
   
7. Configura el tipo de ejecución en "Activador".
8. Guardar

¡Ya tienes tu SpreadSheet conectado a Fracttal!