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.
- Crea proyectos nuevos.
- Visualiza los detalles de tus proyectos, como los alcances de OAuth que usa.
- Supervisa el estado y el uso de tus proyectos de secuencias de comandos.
- Consulta los registros de ejecución de tus proyectos y 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 secuencias 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. El panel de navegación izquierdo del panel divide estos proyectos en las siguientes categorías:
- Proyectos destacados. Proyectos que monitoring.
- Mis proyectos. Proyectos de los que eres propietario
- Todos los proyectos. Proyectos de los que eres propietario o para los que tienes permisos de lectura o edición
- Compartidos conmigo. Proyectos que no te pertenecen, pero que se compartieron contigo.
- Papelera. Proyectos que quitaste de Google Drive
Las listas de proyectos muestran el nombre del proyecto, el propietario y la fecha de la última modificación. Los íconos junto al nombre del proyecto indican si se trata de un proyecto independiente o vinculado.
Ver detalles del proyecto
Cada proyecto incluye una vista para consultar los detalles del proyecto a los desarrolladores. 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 los datos y grafos del proyecto en Tasa de errores, Ejecuciones y Usuarios, así como los permisos de OAuth que se solicitan a cualquier usuario final que use el proyecto. Las métricas de datos se definen de la siguiente manera:
- Tasa de errores. El porcentaje de ejecuciones que no se pudieron ejecutar debido a excepciones no detectadas. Se calcula como ejecuciones con errores divididos por el total de ejecuciones durante el período definido.
- Ejecuciones La cantidad de veces que un proyecto se “ejecutó” o ejecutó. Consulta Tipos de ejecución para obtener más información sobre cómo se puede ejecutar un proyecto.
- Usuarios. 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, por lo que no se reflejan en el recuento de usuarios ni en los grafos.
Cada implementación del proyecto aparece como una pestaña en la página Detalles del proyecto sobre los datos y gráficos; puedes seleccionar la pestaña para ver los datos asociados a esa implementación. Si seleccionas TODO, se muestran los 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.
Supervisar proyectos
Es posible que tengas acceso a muchos más proyectos de Apps Script de los que usas o administras en forma habitual. Destaca proyectos para agregarlos con facilidad. Destacar proyectos también te permite supervisar estadísticas y gráficos agregados de uso 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 si haces clic en Más mientras visualizas 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 Tasa de errores, Ejecuciones o Usuarios en la parte superior de la página para ver los grafos asociados a todos tus proyectos destacados en 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
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.
En la columna Función, se muestra el nombre de la función que inició la ejecución. No hay 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 la información que 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. Un evento temporal provocó la ejecución.
- Activador La ejecución se originó en una fuente del activador.
- Aplicación web. La ejecución se originó en una app web implementada.
- Editor. La ejecución se originó en el editor de Apps Script.
Finalizar ejecuciones
Las ejecuciones de larga duración que están en curso se indican con un Status como “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 el panel de navegación izquierdo.
En el panel Settings, aparece un botón de activación para la API de Apps Script. Esto te permite otorgar 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 nuevo panel con el texto de advertencia y un interruptor para activar o desactivar. Como precaución de seguridad, el acceso a tus proyectos de secuencias de comandos está desactivado de forma predeterminada. Una vez que otorgas acceso, cualquier aplicación de terceros que autorices puede usar la API para modificar tus implementaciones y secuencias de comandos. Puedes revocar este acceso en el panel de Configuración en cualquier momento.
Obtén más información en la Guía de acceso a la API de Apps Script.