El panel de Apps Script te permite administrar y supervisar tus proyectos de Apps Script. Usa el panel para hacer lo siguiente:
- Ver y buscar tus proyectos de Apps Script existentes, incluidas las secuencias de comandos vinculadas a documentos de Google Workspace
- Crear proyectos nuevos
- Ver detalles sobre tus proyectos, como los permisos de OAuth que usan
- Supervisar el estado y el uso de tus proyectos de secuencias de comandos
- Ver los registros de ejecución de tus proyectos y de otros que se ejecutan con las credenciales de tu cuenta
- Activar o desactivar la API de Apps Script para permitir o impedir que las apps usen la API para interactuar con tus proyectos de secuencias de comandos.
Cómo ver y buscar proyectos
En el panel de Apps Script, se enumeran todos los proyectos de secuencias de comandos que puedes ver o editar. El panel de navegación izquierdo del panel divide estos proyectos en las siguientes categorías:
- Proyectos destacados : Proyectos que supervisas
- Mis proyectos : Proyectos de los que eres propietario
- Todos los proyectos : Proyectos de los que eres propietario o para los que tienes permisos de visualización o edición
- Compartido conmigo : Proyectos que no son de tu propiedad, pero que se compartieron contigo
- Papelera : Proyectos que quitaste de Google Drive
En las listas de proyectos, se muestran el nombre del proyecto, el propietario y la fecha de última modificación. Los íconos junto al nombre del proyecto indican si se trata de un proyecto independiente o un proyecto vinculado.
Ver detalles del proyecto
Cada proyecto incluye una vista para ver los detalles del desarrollador sobre el proyecto. Para ver los detalles de un proyecto, haz clic en la fila de la lista de proyectos.
En la vista de detalles del proyecto, se muestran datos y gráficos de Tasa de errores, Ejecuciones y Usuarios sobre el proyecto, así como los permisos de OAuth solicitados a cualquier usuario del proyecto. Las métricas de datos se definen de la siguiente manera:
- Tasa de errores : Es el porcentaje de ejecuciones que no se pudieron ejecutar debido a excepciones no detectadas. Se calcula como las ejecuciones fallidas divididas por el total de ejecuciones durante el período definido.
- Ejecuciones : Es la cantidad de veces que se "ejecutó" un proyecto. Consulta Tipos de ejecución para obtener más información sobre cómo se puede ejecutar un proyecto.
- Usuarios : Es la cantidad de cuentas de usuario únicas que ejecutaron el proyecto una o más veces durante el período especificado. No se hace un seguimiento de los usuarios anónimos y, por lo tanto, no se reflejan en el recuento de usuarios ni en los gráficos.
Cada implementación de tu proyecto aparece como una pestaña en la página Detalles del proyecto que precede a los datos y los gráficos. Selecciona la pestaña para ver los datos asociados de esa implementación. Si seleccionas TODOS , se muestran datos agregados de todas las implementaciones del proyecto y de las ejecuciones resultantes de los desarrolladores que ejecutan el proyecto desde el editor de código de Apps Script.
Los proyectos publicados como complementos no aparecen como implementados en el panel de Apps Script.
Supervisar proyectos
Para marcar proyectos, haz clic en la estrella. Marcar proyectos también te permite supervisar estadísticas y gráficos agregados de uso y tasa de errores.
Para marcar un proyecto, a la derecha de una fila del proyecto, haz clic en Más > Agregar estrella. También puedes marcar un proyecto haciendo clic en Más mientras ves los detalles del proyecto.
En el panel de navegación izquierdo, selecciona Proyectos destacados para ver los proyectos que marcaste. Haz clic en el cuadro de indicadores de Tasa de errores, Ejecuciones o Usuarios en la parte superior de la página para ver los gráficos asociados de todos tus proyectos destacados durante los últimos 7 días.
Para quitar una estrella de un proyecto, haz clic en Más en la fila del proyecto y selecciona Quitar estrella.
Administrar ejecuciones
Usa el panel de Apps Script para ver y administrar ejecuciones individuales de funciones de proyectos de Apps Script. Para encontrar un registro completo de las ejecuciones recientes, selecciona Mis ejecuciones en el panel de navegación izquierdo.
En el panel Mis ejecuciones , se muestra un registro de todas las ejecuciones anteriores y en curso de los proyectos de los que eres propietario, editor o visualizador. Esta lista también puede incluir ejecuciones de funciones en proyectos a los que no tienes acceso si se ejecutan en tu nombre (por ejemplo, complementos que instalaste y ejecutaste). En la lista de ejecución, solo se muestra la función inicial que se llama para iniciar la ejecución. No se muestra cada función llamada durante esa ejecución.
Controla qué tipo de ejecución se informa en el registro con los filtros que se encuentran en la parte superior de la vista. Cada fila del registro representa una sola ejecución. En las columnas Hora de inicio, Duración y Estado, se muestra la información correspondiente sobre esa ejecución.
En la columna Función , se muestra el nombre de la función que inició la ejecución. No hay ningún nombre en esta columna si no tienes acceso al proyecto de secuencia de comandos correspondiente de la ejecución, pero se ejecutó en tu nombre.
En la columna Tipo , se muestra lo que inició la ejecución. Los valores incluyen los siguientes:
- Complemento : La ejecución se originó a partir de un complemento.
- API de Execution : La ejecución se originó a partir de una invocación de la API de Apps Script.
- Controlado por tiempo : La ejecución se produjo debido a un evento de tiempo.
- Activador : La ejecución se originó a partir de una fuente de activación.
- Aplicación web : La ejecución se originó a partir de una app web implementada.
- Editor : La ejecución se originó a partir del editor de Apps Script.
Finalizar ejecuciones
Las ejecuciones de larga duración que están en curso se indican con un Estado de "En ejecución". Para detener estas ejecuciones, a la derecha de la fila del proyecto, haz clic en Más > Finalizar.
Configuración
Para ajustar la configuración del panel, selecciona Configuración en el panel de navegación izquierdo.
En el panel Configuración, hay un botón de activación para la API de Apps Script. Esto te permite otorgar acceso a la API a tus proyectos de secuencias de comandos.
Para acceder a este botón de activación, haz clic en la etiqueta API de Google Apps Script en el panel Configuración. Se abrirá un panel nuevo con texto de advertencia y un botón de activación. El acceso a tus proyectos de secuencias de comandos está desactivado de forma predeterminada como medida de seguridad. Una vez que otorgues acceso, cualquier aplicación de terceros que autorices podrá usar la API para modificar tus secuencias de comandos y tus implementaciones. Revoca este acceso en el panel Configuración en cualquier momento.
Obtén más información en la guía de acceso a la API de Apps Script.