Gérer les projets

Cette section présente les méthodes de l'API Google Apps Script que vous pouvez utiliser pour créer, lire, modifier et surveiller vos projets Google Apps Script. La page Exemples de Gestion de projet présente des exemples de requêtes de gestion d'API. La documentation de référence de chaque méthode fournit des informations sur l'implémentation.

Présentation de la méthode API
Créer des projets

projects.create

Résultats : crée un projet de base vide, sans fichiers de projet et avec un fichier manifeste de projet par défaut.

Options : vous pouvez fournir un titre de projet. Vous pouvez également créer un script lié en fournissant l'ID Google Drive d'un fichier Google Docs, Google Sheets, Google Forms ou Google Slides qui servira de parent au script.

Lire les métadonnées du projet

projects.get

Résultats : récupère un Project objet, qui représente les métadonnées du projet. Ces données incluent le titre du projet, l'ID du script, l'utilisateur créateur, l'heure de création et d'autres informations.

Lire le contenu du projet

projects.getContent

Résultats : renvoie un tableau d'objets File, un pour chaque fichier de code et HTML du projet. La liste inclut également le fichier manifeste du projet au format JSON. Les objets de fichier contiennent le contenu source du fichier (File.source) et d'autres métadonnées, telles qu'une liste de fonctions dans le fichier (File.functionSet).

Options : vous pouvez spécifier la version du contenu à récupérer avec un paramètre de requête.

Mettre à jour le contenu du projet

projects.updateContent

Résultats : modifie le contenu du fichier dans un projet de script. Vous fournissez le nouveau contenu sous forme de tableau d'objets File. L'un de ces objets File doit être de type JSON et représenter le nouveau fichier manifeste du projet. Le nouveau contenu est stocké en tant que version HEAD du projet. Il est utilisé lorsque le script s'exécute en tant que déclencheur, dans l'éditeur de script, en mode Preview de module complémentaire Google Workspace, ou en tant qu'application Web ou API Apps Script en mode développement.

Remarque : Pour mettre à jour le contenu d'un projet de script, envoyez d'abord une requête projects.getContent pour récupérer un tableau des File existants, apportez les modifications souhaitées à ces objets, puis utilisez les File comme entrée pour une requête projects.updateContent.

Avertissement : Le nouveau contenu remplace tous les fichiers existants dans le projet de script. Les fichiers non mis à jour par la requête sont supprimés.

Lire les métriques du projet

projects.getMetrics

Résultats : lit certaines métriques concernant un projet. Ces métriques incluent le nombre d'utilisateurs, le nombre total d' exécutions, le nombre total d'erreurs d'exécution et d'autres informations. Utilisez un MetricType pour spécifier les informations que vous demandez.

Options : limitez les résultats à des déploiements ou à des fonctions de script spécifiques à l'aide d'un MetricsFilter. Vous pouvez également définir un intervalle de métrique spécifique à l'aide d'un MetricsIntervalConfig.