Tableau de bord Apps Script

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 l'une des 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'il utilise.
  • Surveillez l'état et l'utilisation de vos projets de scripts.
  • Affichez les journaux d'exécution de vos projets et de ceux 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 scripts.

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 répartit ces projets en 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 : Projets que vous avez supprimés de Google Drive.

La liste des projets indique leur nom, leur propriétaire et la date de 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'en savoir plus sur le projet pour les développeurs. Pour afficher les détails d'un projet, cliquez sur la ligne dans la liste des projets.

La vue "Détails du projet" affiche les données et graphiques sur le taux d'erreur, les exécutions et les utilisateurs, ainsi que les champs d'application OAuth demandés à tout utilisateur final se servant du 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. Elle est calculée 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 (comptes) uniques 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 n'apparaissent donc pas 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 l'onglet pour afficher les données associées à ce déploiement. La sélection de ALL affiche les données globales de tous les déploiements du projet et des exécutions résultant de l'exécution du projet par les développeurs depuis l'éditeur de code Apps Script.

Surveiller les 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 les marquer comme favoris. Le suivi des projets vous permet également de surveiller les statistiques globales d'utilisation et de taux d'erreur ainsi que les graphiques associés à 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 lorsque vous affichez les détails du projet.

Dans le menu de navigation de gauche, sélectionnez 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 vos projets favoris au cours des sept derniers jours.

Pour supprimer un projet des favoris, cliquez sur Plus sur la ligne du projet et sélectionnez Supprimer le suivi.

Gérer les exécutions

Vous pouvez afficher et gérer les exécutions individuelles des fonctions d'un projet Apps Script à l'aide du tableau de bord 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 Mes exécutions affiche par défaut un journal de toutes les exécutions précédentes et en cours 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 s'ils 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. Il n'affiche pas toutes les fonctions appelées lors de cette exécution.

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 Start Time (Heure de début), Duration (Durée) et Status (État) affichent les informations correspondantes sur cette exécution.

La colonne Fonction indique le nom de la fonction qui a lancé l'exécution. Cette colonne ne contient aucun nom si vous n'avez pas accès au projet de script correspondant, mais que l'exécution a été exécutée en votre nom.

La colonne Type indique ce qui a lancé 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 provient d'un appel de l'API Apps Script.
  • Temporelle : L'exécution a été causée par un événement temporel.
  • Déclencheur. L'exécution provient d'une source de déclencheur.
  • Webapp (Application Web). 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 qui sont en cours sont indiquées par l'état "Running" (En cours d'exécution). Pour arrêter ces exécutions, à droite de la ligne du projet, cliquez sur Plus > Arrêter.

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.

Le panneau Paramètres contient un bouton d'activation/de désactivation pour l'API Apps Script. Cela vous permet d'accorder à l'API l'accès à vos projets de scripts.

Pour accéder à cette option, cliquez sur le libellé API Google Apps Script dans le panneau Paramètres. Un nouveau panneau contenant un texte d'avertissement et un bouton bascule s'ouvre. 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, toutes les applications tierces que vous autorisez peuvent 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.