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 registra un mensaje que se le pasó. Luego, crea una automatización de AppSheet y haz que llame 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 la secuencia de comandos
• Cómo verificar la ejecución correcta de la secuencia de comandos desde AppSheet

Requisitos

• Tener 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

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

1. Abre la hoja de cálculo de Ejemplo de pedidos de camisetas y, luego, haz clic en Crear una copia para descargar y abrir una copia en Hojas de cálculo de Google. Si lo deseas, puedes cambiarle el nombre a la hoja de cálculo (p.ej.,"Pedidos de camisetas").
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 unidad de Google Drive.
8. Navega hasta la hoja de cálculo Shirt Orders que copiaste antes y selecciónala.

AppSheet configurará 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 + Bot nuevo.
3. Selecciona el primer elemento de la lista de sugerencias: Cuando se crea o actualiza un registro de pedidos de camisetas, 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 un script.

7. En el campo Proyecto de Apps Script, haz clic en Explorar (ícono de archivo).
8. Navega hasta el proyecto de Hello World Apps Script 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 agrega el proyecto de Apps Script y el campo Nombre de la función se completa 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: "Hello from 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 camisetas nuevo y haz clic en Guardar.
15. Haz clic en Sincronizar para sincronizar los cambios.

5. Confirma la ejecución de Apps Script

Después de llamar a la secuencia de comandos, vuelve al editor de Apps Script y confirma su ejecución.

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 desde AppSheet.

Comienza a usar 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 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 Cómo llamar a Apps Script desde una automatización, que proporciona una descripción general detallada, un video de la función, instructivos y un proyecto de Apps Script que se puede copiar y que contiene muchos ejemplos prácticos de AppSheet y Apps Script.