El panel de Apps Script te permite administrar y supervisar tus proyectos de Apps Script. Puedes usar el panel para realizar cualquiera de las siguientes acciones:
- Visualiza y busca tus proyectos de Apps Script existentes, incluidas las secuencias de comandos vinculadas que se adjuntan aGoogle Workspace documentos.
- Crear proyectos nuevos
- Consultar los detalles de tus proyectos, como los alcances de OAuth que usan
- Supervisa el estado y el uso de tus proyectos de secuencia de comandos.
- Consulta los registros de ejecución de tus proyectos y de otros que se ejecutan con las credenciales de tu cuenta.
- Activa o desactiva la API de Apps Script para permitir o evitar que las apps usen la API para interactuar con tus proyectos de secuencia de comandos.
Ver y buscar proyectos
En el panel de Apps Script, se enumeran todos los proyectos de secuencias de comandos que puedes ver o editar. La barra de navegación izquierda del panel divide estos proyectos en las siguientes categorías:
- Proyectos destacados. Los proyectos que supervisas
- Mis proyectos. Proyectos de los que eres propietario
- Todos los proyectos. Los proyectos que te pertenecen o en los que tienes permisos de visualización o edición
- Compartidos conmigo. Proyectos que no te pertenecen, pero que se compartieron contigo
- Papelera. Los proyectos que quitaste de Google Drive
En las listas de proyectos, se muestra el nombre del proyecto, el propietario y la fecha de la última modificación. Los íconos junto al nombre del proyecto indican si es un proyecto independiente o vinculado.
Cómo ver los 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 sobre la tasa de error, las ejecuciones y los usuarios del proyecto, así como los permisos de OAuth solicitados a cualquier usuario final que use el 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ó" o 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 usuarios únicos (cuentas) que ejecutaron el proyecto una o más veces durante el período especificado. No se realiza 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 sobre los datos y los gráficos. Puedes seleccionar la pestaña para ver los datos asociados de esa implementación. Si seleccionas TODO, se muestran datos agregados de todas las implementaciones del proyecto y de las ejecuciones que resultan de que los desarrolladores ejecuten el proyecto desde el editor de código de Apps Script.
Supervisa proyectos
Es posible que tengas acceso a muchos más proyectos de Apps Script de los que usas o administras con regularidad. Para agregar proyectos a favoritos y acceder a ellos con facilidad, puedes destacarlos. Marcar proyectos como favoritos también te permite supervisar las estadísticas y los gráficos de uso general y tasa de errores en esos proyectos.
Para destacar un proyecto, a la derecha de la fila de un proyecto, haz clic en Más > Agregar estrella. También puedes destacar un proyecto haciendo clic en Más mientras ves los detalles del proyecto.
En el panel de navegación izquierdo, puedes seleccionar Proyectos destacados para ver los proyectos que agregaste a favoritos. Haz clic en el cuadro de evaluación Porcentaje 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.
Administra ejecuciones
Puedes usar el panel de Apps Script para ver y administrar ejecuciones individuales de las funciones del proyecto de Apps Script. Para encontrar un registro completo de las ejecuciones recientes, selecciona el elemento My Executions en el panel de navegación izquierdo.
El panel My Executions muestra de forma predeterminada un registro de todas las ejecuciones anteriores y actuales 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). La lista de ejecuciones solo muestra la función inicial a la que se llama para iniciar la ejecución. No muestra todas las funciones a las que se llamó durante esa ejecución.
Puedes controlar qué tipo de ejecución se informa en el registro mediante los filtros ubicados en la parte superior de la vista. Cada fila del registro representa una sola ejecución. En las columnas Start Time, Duration y Status se muestra la información correspondiente sobre esa ejecución.
La columna Function 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 a la ejecución, pero se ejecutó en tu nombre.
La columna Tipo muestra qué inició la ejecución. Los valores incluyen los siguientes:
- Complemento. La ejecución se originó en un complemento.
- API de Execution. La ejecución se originó a partir de una invocación de la API de Apps Script.
- Basado en el tiempo. La ejecución se debió a un evento de tiempo.
- Activador La ejecución se originó en una fuente del activador.
- Webapp. La ejecución se originó en una app web implementada.
- Editor. La ejecución se originó en el editor de Apps Script.
Finaliza las ejecuciones
Las ejecuciones de larga duración que están en curso se indican con un estado de "Running". 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 la barra de navegación de la izquierda.
En el panel Configuración, hay un botón de activación para la API de Apps Script. Esto te permite otorgarle a la API acceso a tus proyectos de secuencia 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 un texto de advertencia y un interruptor de activación. El acceso a tus proyectos de secuencia de comandos está desactivado de forma predeterminada como medida de seguridad. Una vez que otorgues acceso, cualquier aplicación de terceros que autorices puede usar la API para modificar tus secuencias de comandos e implementaciones. Puedes revocar 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.