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:
- Consulta y busca tus proyectos existentes de Apps Script, incluidas las secuencias de comandos vinculadas a documentos deGoogle Workspace .
- Crear proyectos nuevos
- Consulta los detalles de tus proyectos, como los permisos de OAuth que usan.
- Supervisa 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
- Activa o desactiva la API de Apps Script para permitir o impedir 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. La navegación izquierda 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 tu propiedad o en los que tienes permiso para ver o editar
- Compartidos conmigo Proyectos que no te pertenecen, pero que se compartieron contigo.
- Papelera Proyectos que quitaste de Google Drive
En las listas de proyectos, se muestran el nombre, 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.
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 correspondiente en la lista de proyectos.
En la vista de detalles del proyecto, se muestran datos y gráficos sobre la tasa de errores, 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 realizar debido a excepciones no detectadas. Se calcula como las ejecuciones con errores divididas por las ejecuciones totales 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 usuarios únicos (cuentas) que ejecutaron el proyecto una o más veces durante el período especificado. No se hace un seguimiento de los usuarios anónimos, por lo que 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 Project Details, arriba de los datos y los gráficos. Puedes seleccionar la pestaña para ver los datos asociados a esa implementación. Si seleccionas ALL, se mostrarán los datos agregados de todas las implementaciones del proyecto y de las ejecuciones que resulten de los desarrolladores que 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 marcar proyectos como favoritos y acceder a ellos fácilmente, puedes destacarlos. Marcar proyectos como favoritos también te permite supervisar las estadísticas y los gráficos agregados de uso y de tasa de errores en esos proyectos.
Para destacar un proyecto, haz clic en Más > Agregar estrella a la derecha de la fila del proyecto. También puedes destacar un proyecto haciendo clic en Más mientras ves los detalles del proyecto.
En la navegación de la izquierda, puedes seleccionar Proyectos destacados para ver los proyectos que marcaste. 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 gráficos asociados de todos tus proyectos destacados durante los últimos 7 días.
Para quitar la 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 ver un registro completo de las ejecuciones recientes, selecciona el elemento Mis ejecuciones en la navegación de la izquierda.
De forma predeterminada, 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 a la que se llama para comenzar la ejecución. No muestra todas las funciones que se llamaron durante esa ejecución.
Puedes controlar qué tipo de ejecución se registra 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. Las columnas Hora de inicio, Duración y Estado muestran 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 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.
- Impulsadas por el tiempo: La ejecución se debió a un evento de tiempo.
- Activador La ejecución se originó a partir de una fuente de activación.
- Webapp. 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 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 menú 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 otorgar a la API acceso a tus proyectos de secuencias de comandos.
Para acceder a este botón de activación, haz clic en la etiqueta Google Apps Script API 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. Puedes revocar este acceso en el panel de Configuración en cualquier momento.
Encontrarás más información en la guía de acceso a la API de Apps Script.