Conecta 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 registre un mensaje que se le pasó. Luego, creas una automatización de Appsheet y le haces llamar a la secuencia de comandos. Después de llamar a la secuencia de comandos, vuelves al editor de Apps Script y confirmas su ejecución.

Qué aprenderás

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

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 registre 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.
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. 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 Ejemplo de pedidos de camisas y, luego, haz clic en Hacer una copia para descargar y abrir una copia en Hojas de cálculo de Google. De manera opcional, puedes 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 app nueva. Aparecerá el diálogo Crear una app nueva.
4. Haz clic en Start with your own data.
5. De manera opcional, edita el nombre de la app y selecciona una categoría.
6. Haz clic en Elige tus datos.

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

AppSheet configura tu app.

9. Haz clic en Customize your app para abrir la app 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.
2. Haz clic en + Nuevo bot.
3. Selecciona el primer elemento de la lista de sugerencias: Cuando se cree o actualice un registro de Pedidos de camisas, envía una notificación.

4. Haz clic en el paso Enviar una notificación para editarlo.
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 hasta el proyecto de Apps Script Hello World en tu unidad de Drive y selecciónalo.
9. 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.

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

Aparecerá el campo Argumentos de la función.

11. Para el argumento msg, ingresa la siguiente expresión con el Asistente de expresiones: “Hola de AppSheet”

12. Haz clic en Guardar para guardar la app.
13. En el panel de vista previa, haz clic en el ícono de dispositivo móvil o tablet para mostrar el emulador de la app.

14. Agrega un pedido de camisa nuevo y haz clic en Guardar.
15. Haz clic en Sync para sincronizar los cambios.

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 consulta 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 el registro no aparece.

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 Run para autorizar las apps del proyecto.

Experimenta con varios de los ejemplos

• createCalendarEvent(): Crea un evento de Calendario nuevo.
• createDoc(): Crea automáticamente un documento nuevo.
• createSheet(): Crea una hoja 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.