Editor de secuencias de comandos de Google Apps: todo lo que necesita saber para comenzar
Si utiliza servicios de Google como Google Docs, Google Sheets, Google Analytics, Gmail y otros, puede conectar y automatizar esos servicios mediante Google Apps Script.
Piense en Google Apps Script como una versión de Google del script Microsoft VBA. Así como puede automatizar tareas y asignaciones o personalizar macros en Microsoft Word y Excel con VBA, puede automatizar tareas y asignaciones en los servicios de Google. En servicios como Hojas de cálculo y Documentos, incluso puede escribir sus propios menús personalizados.
En este artículo, aprenderá cómo acceder y habilitar las aplicaciones de secuencias de comandos en sus diversos servicios de Google, cómo navegar por las aplicaciones del editor de secuencias de comandos y cómo conectar los servicios. No aprenderá funciones de secuencias de comandos específicas, pero Google tiene excelentes tutoriales de secuencias de comandos documentados y aplicaciones para aprender a escribir aplicaciones de secuencias de comandos.
Cómo acceder al Editor de secuencias de comandos de Google Apps
Puede abrir el editor de código de Google Apps Script desde algunos servicios de Google. Por ejemplo, obtienes Guión de aplicación sa Extensiones menú dentro de Hojas de cálculo de Google.
En otros servicios, puede abrir el editor de Google Apps Script de las siguientes maneras:
- Documentos de Google: Seleccione editor de guiones sa Herramientas menú.
- Presentaciones de Google: Seleccione editor de guiones sa Herramientas menú.
- Formularios de Google: Seleccione editor de guiones en el menú de tres puntos.
- Google Drive: Haga clic derecho en cualquier espacio en blanco, seleccione Másy seleccione Guión de aplicaciones de Google.
Usando cualquiera de estos métodos, verá un editor de código de Apps Script abierto en una nueva pestaña. Esta es la ventana donde escribirá todas las funciones que componen todo su script. De manera predeterminada, verá una función vacía llamada myFunction () que está lista para completar su código.
Nota: El formato del código es muy importante para evitar errores. Use el comentario como se muestra en el siguiente código para recordar lo que estaba tratando de hacer dentro de las partes del código. Esto es muy similar a cómo funcionan los comentarios en código HTML con la programación web.
Mientras navega al editor de código, puede volver a esta sección seleccionando Código.gs en el panel de navegación izquierdo editor ventana. Para ver otras Windows disponibles, desplace el cursor sobre los iconos en el panel izquierdo y se abrirá el panel de navegación principal.
el es Visión de conjunto Este artículo es donde puede encontrar estadísticas sobre su secuencia de comandos, como cuántos errores ocurrieron, cuántas veces se hizo y más.
Cubriremos todas las demás secciones del editor de Google Apps Script en cada sección a continuación.
Vaya al Editor de secuencias de comandos de Google Apps
A medida que edita su código en el editor, es una buena idea seleccionar el icono de disco (Guardar) con frecuencia para no perder su trabajo.
Una vez guardado, verá aparecer las otras opciones del menú.
Éstos incluyen:
- Correr: intente ejecutar todo el script de principio a fin.
- depurado: Avance a través de su guión una línea a la vez.
- Función pasada: Explore y navegue hasta cada una de las funciones que ha creado.
- Registro de ejecución: compruebe si hay mensajes de estado o de error de todos los intentos de ejecutar su secuencia de comandos.
el es bibliotecas El menú de navegación de la izquierda es una opción en la que puede acceder a bibliotecas escritas por otros (o escritas y guardadas en otro lugar). Esto es útil si ya tiene un amigo que ha escrito una función que le gustaría usar en Google Sheets o Google Docs pero le gustaría agregar funciones adicionales.
Todo lo que tiene que hacer es ingresar esas bibliotecas en su proyecto o en la ID del script. Puede encontrar esto en la sección sobre la configuración del proyecto, que le mostrará cómo acceder al final de este artículo.
Complementos de servicios de secuencias de comandos de Google Apps
el es Servicios artículo más útil. Aquí es donde puede integrar su secuencia de comandos actual con otros servicios de Google que puede usar.
Una vez que lo selecciones, verás el Agregar servicio ventana abierta Desplácese hacia abajo hasta el servicio que desea utilizar como complemento de su proyecto actual.
Por ejemplo, si desea extraer datos de su cuenta de Google Analytics en este script, puede API de análisis de Googley seleccione Por favor.
Si desea detalles de las funciones disponibles para usar con este nuevo servicio de complemento y cómo usarlas, seleccione los tres puntos en el lado derecho de la API y seleccione Ver documentación.
Esto abrirá la documentación de Google Apps Script en una nueva pestaña, que se abrirá automáticamente en la sección de ese servicio de Google.
Explore la documentación para ver la sintaxis de funciones, tutoriales y ejemplos de código que puede usar en su propio script.
Además, tenga en cuenta que puede navegar a otras secciones de la documentación para ver qué funciones generales están disponibles en su secuencia de comandos según el servicio que utilizó cuando abrió el editor de código.
Por ejemplo, si abrió el editor en Hojas de cálculo de Google, marque la Hojas sección en el menú de documentación para las funciones de Hojas de cálculo de Google que puede usar en su secuencia de comandos.
Configuración y uso de secuencias de comandos de aplicaciones de activación
Otra característica útil de Google Apps Script es la capacidad de establecer un activador en función de una serie de eventos o programaciones.
Para configurar un nuevo activador para su secuencia de comandos, seleccione Desencadenar desde el menú de navegación en el extremo izquierdo. En la nueva ventana Activadores que se abre, seleccione el Agregar disparador botón.
La ventana Agregar disparador tiene una larga lista de opciones que lo ayudan a personalizar con precisión cómo y cuándo desea que se ejecute su secuencia de comandos.
Nota: muchas de estas opciones dependen del servicio para el que esté escribiendo su script o de las API que haya agregado.
Para configurar su disparador, necesitará:
- Qué función lanzar primero
- El origen del evento, como una hora, fecha o evento específico en su servicio, como cuando cambia una celda de hoja de cálculo de Google o cuando se abre un documento por primera vez.
- El tipo de evento, como al abrir o editar algo en su hoja de cálculo o documento de Google, o la configuración específica de fecha u hora.
- Frecuencia de notificación sobre la frecuencia con la que desea recibir actualizaciones sobre cuándo fallaron sus scripts
cuando eliges SalvarEs posible que vea el mensaje «Error en la autorización del script» si es la primera vez que guarda un nuevo disparador.
Esto generalmente se activa si un bloqueador de Windows emergentes está habilitado en su navegador. Si está utilizando Google Chrome, todo lo que tiene que hacer es seleccionar el icono de la pequeña ventana roja «X». Cambie la configuración a Permitir siempre las Windows emergentes y seleccione Hecho.
cuando eliges Salvar nuevamente, deberá seguir el proceso para autorizar la secuencia de comandos que escribió para que se ejecute en su cuenta de Google o Google Workspace.
Primero, seleccione la cuenta de Google en la que desea permitir que se ejecute su secuencia de comandos.
Verá una advertencia de que Google no ha «verificado» la función personalizada o el script que ha escrito. Si usted es la persona que escribió el script, no importa y es seguro ejecutarlo con su propia cuenta de Google o Google Workspace.
Para omitir esta advertencia, seleccione casta y luego seleccione el Ir
Finalmente, en la ventana de permisos, seleccione Permitir para permitir que sus funciones y secuencias de comandos personalizadas se ejecuten en su cuenta de Google o Google Workspace.
No necesitará repetir este proceso, solo la primera vez que guarde o ejecute sus proyectos de script personalizados de Google Apps.
Acceso a su ID de Google Script
Una nota final: es posible que desee poner su secuencia de comandos a disposición de sus amigos o colegas para que puedan usar su secuencia de comandos o agregarla como una biblioteca con su propia secuencia de comandos.
Puede encontrar su ID de secuencia de comandos en el ícono de Configuración en el panel de navegación del extremo izquierdo.
El ID del script se puede encontrar bajo el identificaciones sección, a la derecha de ID de secuencia de comandos.
Como puede ver, el editor de Google Apps Script es relativamente simple si sabe cómo navegar a todas las funciones que desea usar. Asegúrese de estudiar bien los documentos de Google Apps Script para que pueda comenzar a aprender cómo escribir sus scripts y todas las funciones disponibles para su uso.
