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 existentes de Apps Script, incluidas las secuencias de comandos vinculadas a los documentosGoogle Workspace .
- Crea proyectos nuevos.
- Visualiza los detalles de tus proyectos, como los permisos de OAuth que usa.
- Supervisa el estado y el uso de tus proyectos de secuencias de comandos.
- Visualiza 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 a fin de interactuar con tus proyectos de secuencias de comandos.
Ver y buscar proyectos
El panel de Apps Script enumera 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 tienes permisos de lectura o edición
- Compartido conmigo. Proyectos que no son de tu propiedad, 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 el proyecto es independiente o 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 los datos y gráficos de Tasa de error, Ejecuciones y Usuarios del proyecto, así como los alcances de OAuth solicitados por cualquier usuario final que use el proyecto. Las métricas de datos se definen de la siguiente manera:
- Tasa de error. El porcentaje de ejecuciones que no se ejecutaron debido a excepciones no detectadas. Se calcula como ejecuciones fallidas divididas por las ejecuciones totales durante el período definido.
- Ejecuciones. 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. Los usuarios anónimos no se registran 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 de 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 TODOS, se mostrarán 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 con regularidad. Para destacar proyectos con facilidad, puedes destacarlos. Destacar proyectos también te permite supervisar el uso agregado y las estadísticas y los gráficos de tasa de error en esos proyectos.
Para destacar un proyecto, haz clic en Más a la derecha de la fila 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 marcaste. Haz clic en el cuadro de evaluación Tasa de error, Ejecuciones o Usuarios en la parte superior de la página para ver los gráficos asociados de 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 de 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 obtener un registro completo de las ejecuciones recientes, selecciona el elemento My Executions (Mis ejecuciones) en el panel de navegación izquierdo.
En el panel Mis ejecuciones, se muestra de forma predeterminada un registro de todas las ejecuciones anteriores y en ejecución para los proyectos de los que eres propietario, editor o lector. 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 ejecución solo muestra la función inicial 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 registra en el registro mediante los filtros 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.
La columna Función 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 lo que 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.
- Conducidos por el tiempo. La ejecución se debe a un evento de tiempo.
- Activador La ejecución se originó de una fuente activadora.
- Aplicación web. La ejecución se originó de una aplicación web implementada.
- Editor. La ejecución se originó desde el editor de Apps Script.
Finalizar ejecuciones
Las ejecuciones de larga duración que están en curso se indican con un Estado de "Running". Para detener estas ejecuciones, haz clic en Más en A la derecha de la fila del proyecto.
Configuración
Puedes ajustar la configuración del panel si seleccionas Configuración en el panel de navegación izquierdo.
En el panel Settings, se encuentra 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, 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 interruptor. El acceso a tus proyectos de secuencia de comandos está desactivado de forma predeterminada como medida de seguridad. Una vez que otorgues el 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 Configuración en cualquier momento.
Obtén más información en la guía de acceso a la API de Apps Script.
Asistencia
Si encuentras un error o necesitas ayuda para usar el panel de Apps Script, primero debes buscarlo o publicarlo en Stack Overflow:
Errores
Si determinaste que la causa de un problema es un error en el panel, puedes buscar en nuestro sitio de Seguimiento de problemas para determinar si es un problema conocido. Si es así, puedes destacar el problema (haz clic en la estrella junto al número de problema), ya que priorizamos los errores que reciben más estrellas. También puedes agregar comentarios a los problemas existentes, pero solo debes hacerlo si se trata de información adicional o contextual sobre el problema.
Si el problema es completamente nuevo, también puedes informarlo en nuestro sitio de Seguimiento de problemas. Si lo haces, asegúrate de incluir la siguiente información en la descripción del error:
- Una descripción del problema y el comportamiento que se esperaba
- Una lista de pasos que se pueden utilizar para reproducir el problema.
- Una descripción del resultado que esperabas y lo que realmente ocurrió (incluí los mensajes de error que recibiste)
- Información sobre tu entorno de desarrollo, incluido el lenguaje de programación y las versiones de bibliotecas, entre otros datos.
Ten en cuenta que los errores pueden estar relativamente inactivos por un tiempo. Esto no significa que nunca resolveremos el problema; solo quiere decir que no hay actualizaciones en este momento.
Faltan funciones
Si falta alguna característica o función que no quieras incluir en el panel, puedes buscar en nuestro sitio de Seguimiento de problemas para determinar si otras personas las solicitaron. Si ya se solicitó, destácalo (haz clic en la estrella junto al número de problema), ya que priorizamos los errores que reciben más estrellas. También puedes agregar comentarios a los problemas existentes, pero solo debes hacerlo si se trata de información adicional o contextual sobre el problema.
Si todavía no se solicitó la función, puedes presentar una solicitud en nuestro sitio de Seguimiento de problemas. Describe la funcionalidad específica que deseas agregar y las razones por las cuales crees que es importante. Si es posible, incluye información específica sobre tu caso práctico y las nuevas oportunidades que brindaría la función.