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:
- Afficher et rechercher vos projets Apps Script existants, y compris les scripts liés joints aux documentsGoogle Workspace .
- Créez des projets.
- Affichez des informations sur vos projets, comme 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 non les applications à utiliser l'API 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 panneau de navigation de gauche du tableau de bord divise ces projets en catégories:
- Projets suivis Les projets que vous surveillez
- Mes projets. Projets dont vous êtes propriétaire
- Tous les projets. Projets dont vous êtes propriétaire ou pour lesquels vous disposez d'autorisations de lecture ou de modification
- Partagé avec moi. Projets dont vous n'êtes pas propriétaire, 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, le propriétaire et la date de la dernière modification du projet. Les icônes à côté du nom du projet indiquent s'il s'agit d'un projet autonome ou d'un projet lié.
Afficher les détails du projet
Chaque projet inclut une vue permettant d'afficher les informations du développeur sur le projet. Pour afficher les détails d'un projet, cliquez sur la ligne correspondante dans la liste des projets.
La vue d'informations détaillées sur le projet affiche les données et les graphiques sur le taux d'erreur, les exécutions et les utilisateurs du projet, ainsi que les champs d'application OAuth demandés à tout utilisateur final utilisant le projet. Les métriques de données sont définies comme suit:
- Taux d'erreur Pourcentage d'exécutions ayant échoué 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 au cours de la période définie.
- Exécutions. Nombre de fois où un projet a été "exécuté" ou exécuté. Pour en savoir plus 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. Si vous sélectionnez TOUT, les données agrégées de tous les déploiements du projet et des exécutions résultant des développeurs qui exécutent le projet depuis l'éditeur de code Apps Script s'affichent.
Surveiller des projets
Vous pouvez avoir accès à un nombre beaucoup plus important de projets Apps Script que vous n'utilisez ou ne gérez régulièrement. Pour ajouter des projets à vos favoris et y accéder facilement, vous pouvez les ajouter aux favoris. 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 une étoile à un projet, cliquez sur Plus > Ajouter une étoile à droite de la ligne du projet. Vous pouvez également ajouter un projet aux favoris en cliquant sur Plus lorsque vous consultez les détails du projet.
Dans le panneau de navigation de gauche, vous pouvez sélectionner Projets avec étoile 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 à tous vos projets épinglés au cours des sept derniers jours.
Pour supprimer une étoile d'un projet, cliquez sur Plus dans la ligne du projet, puis sélectionnez Supprimer l'étoile.
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 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.
Le panneau Mes exécutions affiche par défaut un journal de toutes les exécutions précédentes et en cours d'exécution pour les 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 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 enregistré 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. Aucun nom n'est indiqué dans cette colonne si vous n'avez pas accès au projet de script correspondant à l'exécution, mais qu'il a été exécuté en votre nom.
La colonne Type indique ce qui a déclenché l'exécution. Voici quelques valeurs :
- Module complémentaire L'exécution provient d'un module complémentaire.
- API d'exécution L'exécution provenait d'un appel de l'API Apps Script.
- 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.
- Webapp : L'exécution provient d'une application Web déployée.
- Éditeur L'exécution provient 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 Running (En cours). Pour arrêter ces exécutions, à droite de la ligne du projet, cliquez sur Plus > Arrêter.
Paramètres
Vous pouvez modifier les paramètres de votre tableau de bord en sélectionnant Paramètres dans le panneau de navigation de gauche.
Dans le panneau Settings (Paramètres), vous trouverez un bouton d'activation/de désactivation de l'API Apps Script. Vous pouvez ainsi accorder à l'API l'accès à vos projets de script.
Pour y accéder, cliquez sur l'icône API Google Apps Script dans le panneau Paramètres. Un nouveau panneau s'ouvre avec un texte d'avertissement et un bouton d'activation/de désactivation. Pour des raisons 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 Settings (Paramètres).
Pour en savoir plus, consultez le guide d'accès à l'API Apps Script.