Conectar AppSheet con Apps Script

1. Introducción

En este codelab, crearás un proyecto de Apps Script llamado “Hello World” y, luego, agregarás una función simple, logThis, que registra un mensaje que se le pasó. Luego, creará una automatización de AppSheet y hará que llame a la secuencia de comandos. Una vez que se llama a la secuencia de comandos, regresa al editor de Apps Script y confirma su ejecución.

Qué aprenderá

• Cómo crear un proyecto de Apps Script con una función simple
• Cómo crear una aplicación de AppSheet sencilla 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 la secuencia de comandos
• Cómo comprobar si la secuencia de comandos se ejecutó correctamente desde AppSheet

Requisitos

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

2. Cree un proyecto de Apps Script

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

1. Vaya a la página principal de Apps Script y haga clic en + Proyecto nuevo.
2. Cambiar el título del proyecto a Hello World.
3. Actualiza la secuencia de comandos en el editor de la siguiente manera:

function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}

4. Haz clic en Guardar proyecto.

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

3. Cree una aplicación de AppSheet

A continuación, generará rápidamente una nueva aplicación de AppSheet basada en una hoja de cálculo de Google de ejemplo y, luego, la actualizará para llamar al proyecto de Apps Script que creó antes.

1. Abra la hoja de cálculo Ejemplo de pedidos de camisetas y, luego, haga clic en Crear una copia para descargarla y abrirla en Hojas de cálculo de Google. Si lo desea, puede cambiar el nombre de la hoja de cálculo (p.ej.,"Pedidos de camisas").
2. Accede a AppSheet.
3. En la página Mis apps, haz clic en + Crear una nueva app. Aparecerá el diálogo Create a new app.
4. Haga clic en Comenzar con sus propios datos.
5. Si lo deseas, edita el nombre de la app y selecciona una categoría.
6. Haga clic en Elegir sus datos.

7. Haz clic en google para acceder a Google Drive.
8. Navegue a la hoja de cálculo Pedidos de camisetas y selecciónela.

AppSheet configura su aplicación.

9. Haga clic en Personalizar su aplicación para abrirla en el editor de AppSheet.

4. Crea una automatización

A continuación, creará una automatización de AppSheet y la llamará a la secuencia de comandos.

1. Seleccione Automatización > Bots.
2. Haga clic en + Nuevo bot.
3. Seleccione el primer elemento de la lista de sugerencias: Cuando se crea o actualiza un registro de pedidos de camisetas, envíe una notificación.

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

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

7. En el campo Apps Script Project, haz clic en Explorar (ícono de archivo).
8. Navega al proyecto de Apps Script Hello World y selecciónalo en tu unidad.
9. Haga clic en Seleccionar y, si se le solicita que autorice, haga clic en Autorizar y siga las indicaciones.

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

10. Seleccione logThis(msg) de la lista Nombre de la función.

Se muestra el campo Argumentos de función.

11. Para el argumento msg, ingrese la siguiente expresión con el Asistente de expresión: "Hello from AppSheet".

12. Haga clic en Guardar para guardar la aplicación.
13. En el panel Preview, haz clic en el ícono de mobile o de tablet para mostrar el emulador de la app.

14. Agregue un nuevo pedido de camisa y haga clic en Guardar.
15. Haz clic en Sincronizar para sincronizar tus cambios.

5. Confirme la ejecución de Apps Script

Después de que se llame a la secuencia de comandos, regrese al editor de Apps Script y confirme la ejecución.

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

6. Pasos adicionales opcionales

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

Comience a usar los ejemplos de Apps Script

1. Para comenzar, primero crea 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 Run 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 nueva hoja.
• createSlideDeck(): Crea una nueva presentación de diapositivas con una imagen y texto.

Para obtener más información sobre esta función importante, consulte Llame a Apps Script desde una automatización, que ofrece una descripción general detallada, un video de funciones, instructivos y un proyecto de Apps Script que se puede copiar, el cual contiene muchos ejemplos prácticos de AppSheet-Apps Script.