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 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: vous avez créé un projet de base et vide, sans fichiers de projet et avec un fichier manifeste de projet par défaut.

Options: vous pouvez indiquer un titre de projet. Vous pouvez également créer un script associé en fournissant l'ID Google Drive d'un fichier Google Docs, Google Sheets, Google Forms ou Slides pour qu'il agisse en tant que 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, l'utilisateur ayant créé le script, 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 code et fichier 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 à l'aide d'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 avoir le 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 script, en mode Preview du module complémentaire ou en tant qu'application Web ou API Apps Script en mode développement.

Remarque: Lorsque vous mettez à jour le contenu d'un projet de script, il est courant d'abord d'envoyer une requête projects.getContent pour récupérer un tableau des File existants, d'effectuer les modifications souhaitées sur 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: lire certaines métriques sur 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 filtre de métriques. Vous pouvez également définir un intervalle de métriques spécifique à l'aide d'un MetricsIntervalConfig.