Le tableau de bord Apps Script vous permet de gérer et pour surveiller vos projets Apps Script. Vous pouvez utiliser le tableau de bord les éléments suivants:
- Afficher et rechercher vos projets Apps Script existants, y compris scripts bound associés à Google Workspace documents.
- Créer des projets
- afficher les détails de vos projets, tels que les Champs d'application OAuth qu'il utilise.
- 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 de la classe identifiants de connexion.
- 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 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 comme suit : catégories:
- Projets suivis Les projets que vous surveillez.
- 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. La situées à côté du nom du projet indiquent s'il s'agit d'un projet autonome un projet ou un projet 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 le taux d'erreur, les exécutions et les utilisateurs. des données et des graphiques sur le projet, ainsi que Champs d'application OAuth demandés à tout utilisateur final utilisant le projet. Les métriques des données sont définies comme suit:
- Taux d'erreur. Pourcentage d'exécutions dont l'exécution a échoué en raison des exceptions non détectées. Il est calculé en divisant le nombre d'exécutions ayant échoué par le nombre 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ées. Consultez la section Types d'exécution pour en savoir plus sur la manière le projet peut être exécuté.
- Utilisateurs : Le nombre d'utilisateurs uniques (comptes) ayant exécuté le projet un ou au cours de la période spécifiée. Les utilisateurs anonymes ne sont pas suivis et ne sont donc pas reflétées dans le nombre d'utilisateurs ni dans les graphiques.
Chaque déploiement de votre projet apparaît sous la forme d'un onglet dans la section Détails du projet. au-dessus des données et des graphiques. vous pouvez sélectionner l'onglet pour voir les données associées à ce déploiement. Sélectionner TOUTES les émissions agréger les données relatives à tous les déploiements du projet et aux exécutions résultant de l'exécution du projet par des développeurs à partir d'Apps Script éditeur de code.
Surveiller des projets
Vous avez peut-être accès à beaucoup plus de projets Apps Script que vous n'en utilisez ou que vous gérez régulièrement. Pour ajouter des projets à vos favoris afin d'y accéder facilement, vous pouvez activer le suivi. L'activation du suivi des projets vous permet également de surveiller les statistiques globales d'utilisation et de taux d'erreur et graphiques sur ces projets.
Pour ajouter un projet aux favoris, à droite de la ligne d'un projet, cliquez sur Plus > Activer le suivi. Vous pouvez également ajouter un projet aux favoris en cliquant sur Plus tout en consultant 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é à vos favoris. Cliquez sur Taux d'erreur, Exécutions ou Utilisateurs. en haut de la page pour afficher les graphiques associés à l'ensemble de vos projets favoris au cours des 7 derniers jours.
Pour supprimer un projet des favoris, cliquez sur "Plus". sur la ligne du projet et en sélectionnant 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 fonctions de projet Apps Script. Vous trouverez un journal complet en sélectionnant l'élément Mes exécutions dans le menu de navigation de gauche.
Par défaut, le panneau My Executions (Mes exécutions) affiche un journal de toutes les exécutions précédentes et actuelles des exécutions pour des projets dont vous êtes propriétaire, éditeur ou lecteur vidéo. Cette liste peut également inclure les exécutions de fonctions dans les projets que vous auxquels vous n'avez pas accès s'ils sont exécutés en votre nom (des modules complémentaires que vous avez installés et exécutés). La liste des exécutions n'affiche que la fonction initiale appelé pour lancer l'exécution. Il n'affiche pas toutes les fonctions qui a été appelé lors de cette exécution.
Vous pouvez contrôler le type d'exécution consigné dans le journal à l'aide de la méthode en haut de la vue. Chaque ligne du journal représente un seul l'exécution. Les colonnes Heure de début, Durée et État affichent les les informations correspondantes sur cette exécution.
La colonne Fonction affiche le nom de la fonction qui a initié l'exécution. Il n'y a pas de nom dans cette colonne si vous n'avez pas accès à le projet de script correspondant à l'exécution, mais 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 la méthode 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 signalées par une icône État "En cours d'exécution". Pour arrêter ces exécutions, à droite du projet ligne, cliquez sur Plus > Arrêter.
Paramètres
Vous pouvez modifier les paramètres de votre tableau de bord en sélectionnant Paramètres dans les menu de navigation de gauche.
Dans le panneau Settings (Paramètres), un bouton 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 l'API Google Apps Script dans le panneau Paramètres. Cela ouvre un nouveau panneau avec un texte d'avertissement et un bouton bascule. L'accès à vos projets de script est désactivé par défaut par mesure de précaution. Une fois l'accès accordé, les applications tierces que vous autorisez peut utiliser l'API pour modifier vos scripts et déploiements. Vous pouvez révoquer cet accès dans le panneau Paramètres à tout moment.
Pour en savoir plus, consultez le Guide d'accès à l'API Apps Script