Cómo utilizar App Connect con Google Hojas

Google Sheets es una aplicación basada en web que puedes utilizar con tus compañeros para crear y modificar hojas de cálculo en línea. Utilice App Connect para conectar las Hojas Google a otras aplicaciones, como una aplicación de mensajería. Por ejemplo, cuando se añade una nueva fila a una hoja de cálculo, se le notifica inmediatamente en la aplicación de mensajería.

Versiones de productos y API compatibles

Para saber qué versiones de producto y API admite este conector, consulte Requisitos detallados del sistema en la página de asistencia IBM.

Conexión a Google Hojas

Complete los campos de conexión que ve en la página Conectar > Aplicaciones y API de App Connect Designer ( anteriormente la página Catálogo ) o en el editor de flujo. Si es necesario, trabaje con su administrador de Hojas Google para obtener estos valores.

Tipos de autorización y campos de conexión de Hojas de cálculo Google :

Tipo de autorización Campos de conexión Aplicabilidad
Utilice el sitio web de la aplicación para iniciar sesión (OAUTH 2.0 AUTH CODE) ID de cliente de la aplicación App Connect
Secreto del cliente de la aplicación
Proporcionar credenciales para que App Connect las utilice (OAUTH BÁSICO) ID de cliente de la aplicación App Connect y App Connect in containers
Secreto del cliente de la aplicación
Señal de acceso de Oauth
Token de actualización OAuth
La siguiente tabla contiene descripciones de los campos de conexión.
Consejo:

Para conectarse mediante el método de autorización OAuth 2.0 del sitio web, consulte Cómo conectarse a una aplicación Google mediante el método de autorización OAuth 2.0 del sitio web

Para generar los valores para el ID de cliente de la aplicación, el secreto del cliente de la aplicación, el token de acceso y el token de actualización, consulte Obtener el ID de cliente de OAuth, el secreto del cliente, el token de acceso y el token de actualización para las aplicaciones Google.
Campo de conexión Descripción
ID de cliente de la aplicación El identificador único que se genera desde la Consola de la API Google y que se asigna a solicitudes de proyectos específicos.
Secreto del cliente de la aplicación El secreto de cliente de aplicación para el ID de cliente de aplicación único creado para un proyecto específico.
Señal de acceso de Oauth El token de acceso que se genera a partir del ID de cliente de la aplicación y el secreto de cliente.
Token de actualización OAuth El token de actualización que se genera a partir del ID de cliente de la aplicación y el secreto de cliente.

Para conectarse a un punto final de Google Sheets desde la página de aplicaciones y API de App Connect Designer por primera vez, expanda Google Sheets y, a continuación, haga clic en Connect (Conectar). Para más información, consulte Gestión de cuentas.

Consejo:

Antes de utilizar la cuenta creada en App Connect en un flujo, cambie el nombre de la cuenta por algo significativo que le ayude a identificarla. Para cambiar el nombre de la cuenta en la página Aplicaciones y API, seleccione la cuenta, abra su menú de opciones (⋮) y, a continuación, haga clic en Cambiar nombre de cuenta.

Lo primero que hay que tener en cuenta

Antes de utilizar App Connect Designer con las hojas Google, tenga en cuenta las siguientes consideraciones:
  • En la página Catálogo de App Connect Designer encontrará listas de los eventos y acciones de activación disponibles.
  • El rendimiento de este conector está restringido por los límites de la API que impone Google. Para más información, consulte Límites y cuotas en las solicitudes API.
  • (Consideración general) Si utiliza varias cuentas para una aplicación, el conjunto de campos que se muestra al seleccionar una acción para esa aplicación puede variar para las distintas cuentas. En el editor de flujo, algunas aplicaciones siempre proporcionan un conjunto curado de campos estáticos para una acción. Otras aplicaciones utilizan la detección dinámica para recuperar el conjunto de campos configurados en la instancia a la que está conectado. Por ejemplo, si tiene dos cuentas para dos instancias de una aplicación, la primera cuenta podría utilizar configuraciones listas para su uso inmediato. Sin embargo, la segunda cuenta puede estar configurada con campos personalizados adicionales.

Activación de un flujo con el evento Nueva fila completa añadida

Para utilizar el evento Nueva fila completa añadida, asegúrese de que su hoja de cálculo cumple los siguientes criterios.
  • La hoja de cálculo que seleccione debe tener nombres de columnas en la primera fila.
  • Cuando añada una fila, debe añadirla al final de la hoja de cálculo.
  • La nueva fila debe contener datos para todas las columnas que se nombran en la primera fila.
Si alguna de estas condiciones no se cumple (por ejemplo, si añade una fila en medio de la hoja de cálculo), el flujo no se activa.

Añadir Google Sheets como aplicación de destino

Para utilizar una hoja de cálculo de Google Sheets como aplicación de destino, debe seleccionar una hoja de cálculo que tenga nombres de columnas en la primera fila. Estos nombres de columna se utilizan como campos de destino para su acción. Si la primera fila de la hoja de cálculo no contiene los nombres de las columnas, no podrá hacer coincidir los campos entre las aplicaciones de origen y de destino.
Nota: Si la hoja de cálculo contiene nombres de columna duplicados, sólo se utilizará como campo de destino la primera instancia de cada columna duplicada.

Procesamiento de los datos de la acción Recuperar filas

Cuando se utiliza la acción Recuperar filas para obtener todos los datos de una hoja de cálculo, es posible que se recupere una fila adicional que contenga nombres de columnas. Si tiene previsto procesar los datos recuperados (por ejemplo, utilizando un nodo For each ), deberá eliminar primero la fila de nombres de columna.
Consejo JSONata: Para eliminar el primer elemento de la matriz de objetos que devuelve la acción Recuperar filas, utilice la siguiente expresión JSONata.
$GoogleSheetsRetrieverows[[1..$count($GoogleSheetsRetrieverows)-1]]
Esta expresión devuelve una matriz de objetos.

Eventos y acciones

Google Hojas de eventos

Estos eventos son para cambios en esta aplicación que desencadenan un flujo para empezar a completar las acciones en el flujo.

Nota: En los contenedores, sólo se pueden utilizar cuentas locales para estos eventos.
Objecto Suceso Descripción
Filas Nueva fila completa añadida Se activa cuando se añade una fila nueva y completa al final de una hoja; se activa cuando la fila añadida contiene un valor en todas las columnas que tienen cabecera en la primera fila de la hoja
Hojas de cálculo Nueva hoja de cálculo Disparadores cuando se crea una hoja de cálculo en Google Hojas

Google Hojas acciones

Su flujo completa estas acciones en esta aplicación.

Objecto Acción Descripción
Filas Crear fila Crea una nueva fila en una hoja de cálculo de Google Sheets
Recuperar filas Recupera filas de una hoja en Google Hojas
Hojas de cálculo Crear hoja de cálculo Crea una nueva hoja de cálculo en Google Sheets
Recuperar hojas de cálculo Recupera hojas de cálculo de Google Sheets
Hojas de trabajo Crear hoja de cálculo Añade una nueva hoja a una hoja de cálculo en Google Hojas

Ejemplos

Mosaico del cuadro de mandos para una plantilla que utiliza Google Hojas
Mosaico del cuadro de mandos para una plantilla que utiliza Google Hojas
Mosaico del cuadro de mandos para una plantilla que utiliza Google Hojas

Utilice plantillas para crear rápidamente flujos para Google Hojas

Aprenda a utilizar App Connect plantillas para crear rápidamente flujos que completen acciones en Google Hojas. Por ejemplo, abra Discover y busque Google Sheets.

Mosaico del cuadro de mandos para una plantilla que utiliza Google Hojas