Le tableau de bord Apps Script vous permet de gérer et de surveiller vos projets Apps Script. Vous pouvez utiliser le tableau de bord pour effectuer les opérations suivantes:
- Affichez et recherchez vos projets Apps Script existants, y compris les scripts liés joints aux documentsGoogle Workspace .
- Créer des projets
- Affichez les détails de vos projets, tels que les champs d'application OAuth qu'ils utilisent.
- Surveillez l'état et l'utilisation de vos projets de script.
- Affichez les journaux d'exécution de vos projets et ceux des autres projets exécutés à l'aide des identifiants de votre compte.
- Activez ou désactivez l'API Apps Script pour autoriser ou empêcher les applications de l'utiliser pour interagir avec vos projets de script.
Afficher et rechercher des projets
Le tableau de bord Apps Script répertorie tous les projets de script que vous pouvez afficher ou modifier. Le menu de navigation de gauche du tableau de bord divise ces projets dans les catégories suivantes:
- Projets suivis Les projets que vous monitoring.
- Mes projets. Les projets dont vous êtes propriétaire.
- Tous les projets. Les projets qui vous appartiennent, ou pour lesquels vous disposez de droits d'affichage ou de modification
- Partagés avec moi : Les projets qui ne vous appartiennent pas, mais qui ont été partagés avec vous
- Corbeille : Les projets que vous avez supprimés de Google Drive.
Les listes de projets indiquent le nom du projet, son propriétaire et la date de sa dernière modification. Les icônes situées à côté du nom du projet indiquent s'il s'agit d'un projet autonome ou lié.
Afficher les détails du projet
Chaque projet inclut une vue permettant d'obtenir des informations sur le projet pour le développeur. Pour afficher les détails d'un projet, cliquez sur la ligne correspondante dans la liste des projets.
La vue détaillée du projet affiche les données et les graphiques relatifs au taux d'erreur, aux exécutions et aux utilisateurs du projet, ainsi qu'aux champs d'application OAuth demandés par tout utilisateur final utilisant le projet. Les métriques des données sont définies comme suit:
- Taux d'erreur. Pourcentage d'exécutions qui n'ont pas pu s'exécuter en raison d'exceptions non détectées. Il est calculé en divisant le nombre d'exécutions ayant échoué par le nombre total d'exécutions sur la période définie.
- Exécutions. Nombre de fois où un projet a été "exécuté" ou exécuté. Pour plus d'informations sur l'exécution d'un projet, consultez la section Types d'exécution.
- Utilisateurs : Nombre d'utilisateurs uniques (comptes) ayant exécuté le projet une ou plusieurs fois au cours de la période spécifiée. Les utilisateurs anonymes ne sont pas suivis et ne sont donc pas reflétés dans le nombre d'utilisateurs ni dans les graphiques.
Chaque déploiement de votre projet apparaît sous la forme d'un onglet sur la page Détails du projet au-dessus des données et des graphiques. Vous pouvez sélectionner cet onglet pour afficher les données associées à ce déploiement. La sélection de ALL permet d'afficher les données globales de tous les déploiements du projet et des exécutions résultant de développeurs qui exécutent le projet à partir de l'éditeur de code Apps Script.
Surveiller des projets
Vous avez peut-être accès à beaucoup plus de projets Apps Script que vous n'utilisez ou ne gérez régulièrement. Pour ajouter des projets à vos favoris afin d'y accéder facilement, vous pouvez activer le suivi. L'ajout de projets aux favoris vous permet également de surveiller l'utilisation agrégée des statistiques et des graphiques concernant l'utilisation et le taux d'erreur de ces projets.
Pour ajouter un projet aux favoris, à droite de la ligne d'un projet, cliquez sur Plus > Ajouter aux favoris. Vous pouvez également ajouter un projet aux favoris en cliquant sur Plus lorsque vous affichez les détails du projet.
Dans le menu de navigation de gauche, vous pouvez sélectionner Projets suivis pour afficher les projets que vous avez ajoutés aux favoris. Cliquez sur le tableau de données Taux d'erreur, Exécutions ou Utilisateurs en haut de la page pour afficher les graphiques associés à tous les projets que vous avez ajoutés aux favoris au cours des sept derniers jours.
Pour supprimer un projet des favoris, cliquez sur Plus sur la ligne du projet en question, puis sélectionnez Supprimer le suivi.
Gérer les exécutions
Vous pouvez utiliser le tableau de bord Apps Script pour afficher et gérer des exécutions individuelles de fonctions de projet Apps Script. Vous pouvez consulter un journal complet des exécutions récentes en sélectionnant l'élément My Executions (Mes exécutions) dans le menu de navigation de gauche.
Le panneau My Executions (Mes exécutions) affiche par défaut un journal de toutes les exécutions précédentes et en cours d'exécution des projets dont vous êtes propriétaire, éditeur ou lecteur. Cette liste peut également inclure les exécutions de fonctions dans des projets auxquels vous n'avez pas accès si elles s'exécutent en votre nom (par exemple, les modules complémentaires que vous avez installés et exécutés). La liste des exécutions n'affiche que la fonction initiale appelée pour démarrer l'exécution. Toutes les fonctions appelées lors de cette exécution ne sont pas affichées.
Vous pouvez contrôler le type d'exécution consigné dans le journal à l'aide des filtres situés en haut de la vue. Chaque ligne du journal représente une seule exécution. Les colonnes Heure de début, Durée et État affichent les informations correspondantes sur cette exécution.
La colonne Fonction affiche le nom de la fonction qui a lancé l'exécution. Cette colonne ne comporte aucun nom si vous n'avez pas accès au projet de script correspondant à l'exécution, mais que celui-ci a été exécuté en votre nom.
La colonne Type indique ce qui a initié l'exécution. Voici quelques valeurs :
- Module complémentaire. L'exécution provenait d'un module complémentaire.
- API Execution. L'exécution provenait d'un appel de l'API Apps Script.
- Déclencheur horaire : L'exécution a été causée par un événement de durée.
- Déclencheur. L'exécution provient d'une source de déclencheur.
- Webapp : L'exécution provenait d'une application Web déployée.
- Éditeur : L'exécution provenait de l'éditeur Apps Script.
Arrêter les exécutions
Les exécutions de longue durée en cours sont indiquées par l'état "En cours d'exécution". Pour arrêter ces exécutions, à droite de la ligne du projet, cliquez sur Plus > Terminer.
Paramètres
Vous pouvez ajuster les paramètres de votre tableau de bord en sélectionnant Paramètres dans le menu de navigation de gauche.
Dans le panneau Settings (Paramètres), vous pouvez activer/désactiver l'API Apps Script. Cela vous permet d'accorder à l'API l'accès à vos projets de script.
Pour accéder à ce bouton, cliquez sur le libellé Google Apps Script API (API Google Apps Script) dans le panneau Settings (Paramètres). Un nouveau panneau contenant un texte d'avertissement et un bouton bascule s'ouvre. Pour des raisons de sécurité, l'accès à vos projets de script est désactivé par défaut. Une fois l'accès accordé, toute application tierce que vous autorisez peut utiliser l'API pour modifier vos scripts et déploiements. Vous pouvez révoquer cet accès à tout moment dans le panneau Settings (Paramètres).
Pour en savoir plus, consultez le guide d'accès à l'API Apps Script.