Gérer des projets

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

Présentation des méthodes API
Créer des projets

projects.create

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

Options: vous pouvez indiquer le titre du 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 Slides qui fera office de parent du script.

Lire les métadonnées du projet

projects.get

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

Lire le contenu du projet

projects.getContent

Results (Résultats) : renvoie un tableau d'objets File, un pour chaque code et fichier HTML du projet. La liste inclut également le fichier manifeste du projet sous forme de fichier JSON. Les objets 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 la forme d'un tableau d'objets File. L'un de ces objets File doit être de type JSON et représenter le nouveau fichier manifeste de projet du projet de script. 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 scripts, en mode aperçu d'un module complémentaire, en tant qu'application Web ou en tant qu'API Apps Script en mode Développement.

Remarque: Lors de la mise à jour du contenu d'un projet de script, il est courant d'envoyer d'abord une requête projects.getContent pour récupérer un tableau des objets File existants, d'en extraire ces objets, puis d'utiliser les File comme entrée pour une requête projects.updateContent.

Avertissement:Le nouveau contenu remplace tous les fichiers existants du 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: lisez 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étriques spécifique à l'aide d'un MetricsIntervalConfig.