Conecta AppSheet con Apps Script

1. Introducción

En este codelab, crearás un proyecto de Apps Script llamado "Hello World" y, luego, agrega una función simple, logThis, que registra un mensaje que se le pasó. Luego, creas una automatización de AppSheet y haces que llame a la secuencia de comandos. Después de llamar a la secuencia de comandos, vuelves al editor de Apps Script y confirmas que se ejecutó.

Qué aprenderás

  • Cómo crear un proyecto de Apps Script con una función simple
  • Cómo crear una app de AppSheet simple a partir de una hoja de cálculo de Google existente
  • Cómo crear una automatización de AppSheet que llame a la función de secuencia de comandos
  • Cómo comprobar si la secuencia de comandos de AppSheet se ejecutó correctamente

Requisitos

  • Acceso al entorno de desarrollo de AppSheet (appsheet.com).
  • Acceso al entorno de desarrollo de Apps Script (script.google.com).

2. Crea un proyecto de Apps Script

Primero, crea un proyecto de Apps Script llamado "Hello World" y, luego, agrega una función simple, logThis, que registra un mensaje que se le pasó.

  1. Ve a la página principal de Apps Script y, luego, haz clic en + Nuevo proyecto.
  2. Cambia el título del proyecto a Hello World. Cuadro de diálogo Cambiar nombre del proyecto con un nombre nuevo.
  3. Actualiza la secuencia de comandos en el editor de la siguiente manera:
function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}
  1. Haz clic en Guardar proyecto.

Para obtener más información, consulta Cómo crear y borrar proyectos.

3. Crea una app de AppSheet

Luego, generarás rápidamente una app nueva de AppSheet basada en una hoja de cálculo de Google de ejemplo y, luego, la actualizarás para llamar al proyecto de Apps Script que creaste antes.

  1. Abre la hoja de cálculo Shirt Orders Example y, luego, haz clic en Make a copy para descargar y abrir una copia en Google Sheets. Si lo deseas, puedes cambiar el nombre de la hoja de cálculo (por ejemplo, "Pedidos de camisas").
  2. Accede a AppSheet.
  3. En la página Mis apps, haz clic en + Crear una nueva app. Se mostrará el diálogo Create a new app.
  4. Haz clic en Comenzar con tus propios datos. Diálogo de creación de aplicaciones nuevos
  5. De manera opcional, edita el nombre de la app y selecciona una categoría.
  6. Haz clic en Elige tus datos.

Seleccionando "Elige tus datos" en el nuevo diálogo de creación de aplicaciones.

  1. Haz clic en google para acceder a Google Drive.
  2. Navega hasta la hoja de cálculo Pedidos de camisas que copiaste antes y selecciónala.

AppSheet configura tu app. Ventana de vista previa inicial para la app generada.

  1. Haz clic en Customize your app para abrirla en el editor de AppSheet.

4. Crea una automatización

A continuación, crearás una automatización de AppSheet y harás que llame a la secuencia de comandos.

  1. Selecciona Automatización > Bots y bots.
  2. Haz clic en + Nuevo bot.
  3. Selecciona el primer elemento de la lista de sugerencias: Cuando se cree o actualice un registro de Shirts, enviar una notificación.

5037cdd726e326e9.png

  1. Haz clic en el paso Enviar una notificación para editarla.
  2. Cambia el nombre a Call a script.

Pasos de automatización para llamar a una secuencia de comandos.

  1. En Configuración, cambia el tipo de tarea a Llamar a una secuencia de comandos.

Al seleccionar "Llamar a una secuencia de comandos" tipo de tarea en la configuración de Automatización.

  1. En el campo Proyecto de Apps Script, haz clic en Explorar (ícono de archivo).
  2. Navega hasta el proyecto de Apps Script Hello World en tu unidad de Drive y selecciónalo.
  3. Haz clic en Seleccionar y, si se te solicita autorización, haz clic en Autorizar y sigue las indicaciones.

Se agregará el proyecto de Apps Script y se completará el campo Nombre de la función con una lista de funciones disponibles.

  1. Selecciona logThis(msg) en la lista Nombre de la función. Selección de la función de Apps Script 'logThis()' en el menú desplegable.

Se mostrará el campo Function Arguments.

  1. En el argumento msg, ingresa la siguiente expresión con el Asistente de expresión: “Hello from AppSheet”.

Agregar argumentos a la llamada a función de Apps Script

  1. Haz clic en Guardar para guardar la aplicación.
  2. En el panel Preview, haz clic en el ícono de mobile o tablet para mostrar el emulador de apps.

68471f4646fc8fbe.png

  1. Agrega un nuevo pedido de camisas y haz clic en Guardar.
  2. Haz clic en Sincronizar para sincronizar los cambios.

Haz clic en el ícono de sincronización en la parte superior derecha del panel de vista previa para sincronizar con la fuente de datos.

5. Confirma la ejecución de Apps Script

Después de llamar a la secuencia de comandos, regresa al editor de Apps Script y confirma que se ejecute.

  1. Regresa a la página principal de Apps Script y visualiza el proyecto Hello World.
  2. Haz clic en Ejecuciones en la barra de navegación para confirmar que la función logThis se completó correctamente. Haz clic en Actualizar si no aparece el registro.

Ver los registros de ejecución en el entorno del editor de Apps Script para verificar la ejecución de la función desde una llamada a AppSheet

6. Pasos adicionales opcionales

Como paso adicional en este taller, revisa el proyecto de ejemplos de Apps Script y ejecuta algunos de los ejemplos de AppSheet.

Comienza con los ejemplos de Apps Script

  1. Para comenzar, primero haz una copia del proyecto de ejemplos de Apps Script.
  2. Haz clic en el ícono de copiar.
  3. Guarda el proyecto nuevo y haz clic en Ejecutar para autorizar las apps en el proyecto.

Experimenta con varios de los ejemplos

  • createCalendarEvent(): Crea un nuevo evento de calendario.
  • createDoc(): Crea automáticamente un documento nuevo.
  • createSheet(): Crea una hoja de cálculo nueva.
  • createSlideDeck() - Crea una nueva presentación de diapositivas con una imagen y texto.

Para obtener más información sobre esta importante función, consulta Llama a Apps Script desde una automatización, que ofrece una descripción general detallada, un video destacado, instructivos y un proyecto de Apps Script copiable que contiene muchos ejemplos de trabajo de AppSheet y Apps Script.