La biblioteca de macros de Automate es un proyecto de scripts de aplicaciones que proporciona funcionalidad de macros para Hojas de cálculo de Google. Con esta biblioteca, puede:
- Añadir la biblioteca de macros de Automate a sus proyectos de scripts de aplicaciones
- Ejecutar funciones de macro directamente desde sus hojas de cálculo
- Interactuar con el agente de Automate incluido con Studio
Requisitos previos
- Acceso del administrador al proyecto de Google Cloud Platform (GCP) o Google Workspace.
- Una cuenta de Google con acceso al script de Google Apps
- El paquete de códigos proporcionado por Precisely
Pasos de configuración
- Active la API del script de aplicaciones en Google Cloud Console > API y servicios > Activar API y servicios.El comando Clasp requiere que se active la API de script de aplicaciones de Google para su proyecto en Google Cloud.Requisito previo obligatorio (una vez): asegúrese de que se permite el ámbito de OAuth necesario en la configuración de consentimiento de OAuth del proyecto (este paso a menudo requiere un administrador de Google Workspace/GCP):Nota: Por lo general, esta configuración es única para cada proyecto de Google Cloud, y suele requerir permisos de administrador de Google Workspace o GCP.
- Agregue el ámbito
https://www.googleapis.com/auth/script.projectsen el proyecto Google Cloud en APIs & Services → Pantalla de consentimiento de OAuth → Acceso a datos.
- Abra la biblioteca de API de Google Cloud Console: https://console.cloud.google.com/apis/library/script.googleapis.com
- Asegúrese de seleccionar el proyecto correcto de Google Cloud (selector de proyecto superior).
- Haga clic en Activar.
Si encuentra errores en los permisos, póngase en contacto con el administrador de Google Workspace o GCP para habilitar la API para su organización o para otorgarle los permisos necesarios.
- Agregue el ámbito
- Instalar la CLI de Clasp
La CLI de Clasp (Command Line Apps Script Projects) le permite administrar proyectos de scripts de aplicaciones desde su terminal.
npm install -g @google/clasp
- Autenticación con Google
Inicie sesión en su cuenta de Google para autorizar Clasp:
clasp login
Siga las indicaciones del navegador para completar la autenticación.
- Crear un nuevo proyecto de script de aplicaciones
-
Crear un nuevo directorio para su proyecto e ir hasta él:
mkdir AutomateMacroLibrary cd AutomateMacroLibrary - Crear un proyecto de script de aplicaciones independiente:
clasp create --title "AutomateMacroLibrary" --type standalone
Esto generará los archivos
.clasp.jsonyappsscript.jsonlocalmente.
-
- Agregar el código de Precisely
- Copie los archivos de códigos proporcionados por Precisely en su directorio de proyecto.
- Sobrescriba el archivo
appsscript.jsonexistente con el proporcionado.
- Insertar archivos en Google
Cargar los archivos locales en el proyecto Apps Script:
clasp push
-
Abra el proyecto del script de aplicaciones en su navegador.
- Vincular el script a un proyecto de Google Cloud (Id. del proyecto)
Algunas funcionalidades (incluidos los escenarios de API ejecutable/API de ejecución) requieren que el script se vincule a un proyecto de Google Cloud. Este es un proceso de configuración único que, por lo general, se completa una vez por proyecto de script de aplicaciones. En muchas organizaciones, solo un administrador de Google Workspace o GCP (o propietario del proyecto) puede realizar este paso.
- En AppsScript, en la configuración de Proyecto, active la casilla Mostrar archivo de manifiesto "appscript.json" en el editor.
- Cree una nueva versión de la biblioteca. Esto es necesario para el uso de la biblioteca.
clasp version "Initial Release"
Nota: Sustituya «Initial Release» por un nombre de versión apropiado para la implementación. -
Implementar como API ejecutable (para el Id. de implementación)
Si la configuración de Evolve requiere un Id. de implementación, deberá crear una implementación de API ejecutable desde la IU de scripts de aplicaciones.
- En el editor de scripts de aplicaciones, haga clic en Implementar → Nueva implementación.
- Haga clic en Seleccionar tipo (icono de engranaje) y seleccione API ejecutable.
- Haga clic en Implementar.
- Copie el Id. de implementación.Nota: La biblioteca se consume utilizando el Id. de script + versión. El Id. de implementación se usa específicamente para el uso de la API ejecutable y la API de ejecución.
- Configurar parámetros de Evolve:
- Copie el Id. de implementación desde la implementación del ejecutable de la API, por ejemplo:
AKfycbxXDwYZaen1spaKYa02DPyE0UdkYpPLcd6OAMlxc7urWGdlVFU39jOeA3z1oC0kf_St - En el sitio de Evolve, en la aplicación Administración, vaya a la pestaña Configuración y seleccione Autenticación.
- En Clientes de hoja de cálculo de Google, pegue el Id. de implementación en el campo Id. de implementación de macro y haga clic en Guardar.
- Copie el Id. de implementación desde la implementación del ejecutable de la API, por ejemplo:
- Obtener el Id. del script:
- Abra el proyecto del script de aplicaciones en su navegador.
- Diríjase a Configuración del proyecto (icono de modificación) y copie el Id. del script.
- Utilice este Id. de script para agregar la biblioteca de macros de Automate a sus proyectos de macros.
- Mantenga el espacio de nombres predeterminado para la biblioteca. Si cambia el nombre de la biblioteca, también debe actualizarlo en el código de ejemplo de macro (
AutomateMacroLibrary.onScript).
Si Precisely comparte actualizaciones del código de script de la aplicación Automate, deberá aplicar esas actualizaciones en su aplicación de macros de Automate. Para ello, debe implementar la última versión de la biblioteca de macros de Automate.
En las plantillas existentes, debe quitar la biblioteca actual y luego agregar la nueva versión de la biblioteca de macros de Automate para asegurarse de utilizar los últimos cambios.