El panel de Apps Script

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 que se adjuntan a documentosGoogle Workspace .
  • Crea proyectos nuevos.
  • Consulta detalles sobre tus proyectos, como los permisos 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 la usen 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. En el panel de navegación izquierdo del panel, se dividen estos proyectos en las siguientes categorías:

  • Proyectos destacados. Proyectos que monitoring
  • Mis proyectos. Los proyectos de los que eres propietario.
  • Todos los proyectos. Los proyectos que son de tu propiedad 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 ver los detalles del proyecto para 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 gráficos y datos del Tasa de error, Ejecuciones y Usuarios, 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. 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 las 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. 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 a esa implementación. Si seleccionas TODO, se mostrarán los datos agregados de todas las implementaciones del proyecto y de las ejecuciones que resultan de los desarrolladores que ejecutan 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. Puedes destacar proyectos para marcarlos y acceder a ellos fácilmente. Destacar proyectos también te permite supervisar las estadísticas y los 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 haciendo clic en Más mientras visualizas sus detalles.

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 gráficos 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.

En el panel My Executions, se muestra de forma predeterminada un registro de todas las ejecuciones anteriores y en ejecución de los proyectos en los que eres propietario, editor o visualizador. En esta lista, también se pueden 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 ejecuciones solo se 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 con los filtros ubicados en la parte superior de la vista. Cada fila del registro representa una sola ejecución. Las columnas Start Time, Duration y Status muestran la información correspondiente sobre esa ejecución.

La columna Función muestra el nombre de la función que inició la ejecución. No hay un nombre en esta columna si no tienes acceso al proyecto de secuencia de comandos correspondiente de la ejecución, pero esta se ejecutó en tu nombre.

La columna Type muestra qué inició la ejecución. Los valores incluyen los siguientes:

  • Complemento. La ejecución se originó de un complemento.
  • API de Execution La ejecución se originó 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ó de la fuente del activador.
  • Webapp. La ejecución se originó desde 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 el estado "En ejecución". Para detener estas ejecuciones, a la derecha de la fila del proyecto, haz clic en Más > Terminate.

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 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 API de Google Apps Script en el panel Settings. Esto abre un nuevo panel con texto de advertencia y un interruptor de activación. El acceso a tus proyectos de secuencias de comandos está desactivado de forma predeterminada como medida de seguridad. Una vez que otorgas el 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 cualquier momento en el panel Configuración.

Obtén más información en la Guía de acceso a la API de Apps Script.