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 associés aux documentsGoogle Workspace .
- créer des projets ;
- Affichez des informations sur vos projets, comme les scopes 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 d'autres qui s'exécutent à l'aide des identifiants de votre compte.
- Activez ou désactivez l'API Apps Script pour autoriser ou empêcher les applications d'utiliser l'API pour interagir avec vos projets de script.
Afficher et rechercher des projets
Le tableau de bord Apps Script liste tous les projets de script que vous pouvez afficher ou modifier. La barre de navigation de gauche du tableau de bord divise ces projets dans les catégories suivantes :
- Projets suivis : Projets que vous surveillez.
- Mes projets : Projets dont vous êtes propriétaire.
- Tous les projets : Projets qui vous appartiennent ou pour lesquels vous disposez d'autorisations d'affichage ou de modification.
- Partagés avec moi Projets qui ne vous appartiennent pas, mais qui ont été partagés avec vous.
- Corbeille. 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 la dernière modification. Les icônes à côté du nom du projet indiquent s'il s'agit d'un projet autonome ou associé.
Afficher les détails du projet
Chaque projet inclut une vue permettant d'afficher les informations sur le développeur du projet. Pour afficher les détails d'un projet, cliquez sur la ligne correspondante dans la liste des projets.
La vue des détails du projet affiche les données et les graphiques sur le projet (Taux d'erreur, Exécutions et Utilisateurs), ainsi que les scopes OAuth demandés à tout utilisateur final du projet. Les métriques de 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 interceptées. Il est calculé en divisant le nombre d'exécutions ayant échoué par le nombre total d'exécutions au cours de la période définie.
- Exécutions. Nombre de fois où un projet a été "exécuté". Pour en savoir plus sur la façon dont un projet peut être exécuté, consultez 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 s'affiche sous forme d'onglet sur la page Détails du projet, au-dessus des données et des graphiques. Vous pouvez sélectionner l'onglet pour afficher les données associées à ce déploiement. Si vous sélectionnez TOUS, les données agrégées de tous les déploiements du projet et des exécutions résultant des développeurs exécutant le projet depuis l'éditeur de code Apps Script s'affichent.
Surveiller les projets
Vous avez peut-être accès à beaucoup plus de projets Apps Script que ceux que vous utilisez ou gérez régulièrement. Pour accéder facilement à vos projets, vous pouvez les ajouter à vos favoris. Vous pouvez également surveiller les statistiques et les graphiques agrégés sur l'utilisation et le taux d'erreur de ces projets.
Pour ajouter un projet à vos favoris, cliquez sur Plus > Ajouter aux favoris à droite de la ligne du projet. Vous pouvez également ajouter un projet aux favoris en cliquant sur Plus lorsque vous affichez les détails du projet.
Dans le panneau de navigation de gauche, vous pouvez sélectionner Projets favoris pour afficher les projets que vous avez ajoutés à vos 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 pour tous vos projets favoris au cours des sept derniers jours.
Pour supprimer un projet des favoris, cliquez sur Plus dans la ligne du projet, puis sélectionnez Supprimer des favoris.
Gérer les exécutions
Vous pouvez utiliser le tableau de bord Apps Script pour afficher et gérer les exécutions individuelles des fonctions du projet Apps Script. Vous trouverez un journal complet des exécutions récentes en sélectionnant l'élément Mes exécutions dans le panneau de navigation de gauche.
Par défaut, le panneau Mes exécutions affiche un journal de toutes les exécutions précédentes et en cours pour les projets dont vous êtes le propriétaire, l'éditeur ou le lecteur. Cette liste peut également inclure des 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 d'exécution n'affiche que la fonction initiale appelée pour démarrer l'exécution. Il n'affiche pas toutes les fonctions appelées lors de cette exécution.
Vous pouvez contrôler le type d'exécution qui est consigné dans le journal à l'aide des filtres 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 Function (Fonction) affiche le nom de la fonction qui a lancé l'exécution. Si vous n'avez pas accès au projet de script correspondant à l'exécution, mais que celle-ci a été effectuée en votre nom, aucun nom ne figure dans cette colonne.
La colonne Type indique ce qui a déclenché l'exécution. Voici quelques valeurs :
- Ajouter. L'exécution provient d'un module complémentaire.
- API Execution L'exécution provient d'une invocation de l'API Apps Script.
- Axé sur le temps : L'exécution a été déclenchée par un événement temporel.
- Déclencheur. L'exécution provient d'une source de déclencheur.
- Application Web L'exécution provient d'une application Web déployée.
- Éditeur : L'exécution provient de l'éditeur Apps Script.
Mettre fin aux exécutions
Les exécutions de longue durée en cours sont indiquées par un état "En cours". Pour arrêter ces exécutions, cliquez sur Plus > Terminer à droite de la ligne du projet.
Paramètres
Pour ajuster les paramètres de votre tableau de bord, sélectionnez Paramètres dans le panneau de navigation de gauche.
Dans le panneau Paramètres, vous trouverez un bouton bascule pour l'API Apps Script. Cela vous permet d'accorder à l'API l'accès à vos projets de script.
Pour accéder à ce bouton bascule, cliquez sur le libellé API Google Apps Script dans le panneau Paramètres. Un nouveau panneau s'ouvre avec un texte d'avertissement et un bouton bascule. Par mesure de sécurité, l'accès à vos projets de script est désactivé par défaut. Une fois que vous avez accordé l'accès, toute application tierce que vous autorisez peut utiliser l'API pour modifier vos scripts et vos déploiements. Vous pouvez révoquer cet accès à tout moment dans le panneau Paramètres.
Pour en savoir plus, consultez le guide d'accès à l'API Apps Script.