Gérer des projets
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 pour chaque méthode fournit des informations sur l'implémentation.
| Présentation des méthodes d'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 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 Slides qui servira de parent au 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 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 manifeste du projet sous forme de fichier JSON. Les objets File contiennent le contenu source du fichier (File.source) et d'autres métadonnées, comme 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.
|
| Modifier le contenu d'un 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 un type JSON et représenter le nouveau fichier manifeste 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 Aperçu 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, la pratique courante consiste à envoyer d'abord une requête
projects.getContent pour récupérer un tableau des File existants, apporter les modifications souhaitées à ces objets, puis utiliser 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 demande 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 détails.
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'une
MetricsIntervalConfig.
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 2025/08/31 (UTC)."],[[["\u003cp\u003eThis section outlines Apps Script API methods for managing Apps Script projects, including creating, reading, updating, and monitoring.\u003c/p\u003e\n"],["\u003cp\u003eYou can create new projects, retrieve project metadata and content, and update project files using these methods.\u003c/p\u003e\n"],["\u003cp\u003eThe API allows you to access project metrics like user count, executions, and errors for analysis.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the provided links for detailed documentation and code samples on project management requests.\u003c/p\u003e\n"]]],[],null,["# Managing Projects\n\nThis section provides an overview of the Apps Script API methods\nyou can use to create, read, modify,\nand monitor your Apps Script projects. The\n[Project Management](/apps-script/api/samples/manage)\nsamples page shows examples of API management requests. The reference\ndocumentation for each method provides implementation details.\n\n| **API method overview** ||\n|----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Create projects** | [projects.create](/apps-script/api/reference/rest/v1/projects/create) **Results** : Create a basic, empty project with no project files and a default [project manifest](/apps-script/concepts/manifests). **Options** : You can provide a project title. You can also create a [bound script](/apps-script/guides/bound) by providing the Google Drive ID of a Google Docs, Google Sheets, Google Forms, or Slides file to act as the script's parent. |\n| **Read project metadata** | [projects.get](/apps-script/api/reference/rest/v1/projects/get) **Results** : Retrieves a [`Project`](/apps-script/api/reference/rest/v1/projects#Project) object, which represents project metadata. This data includes the project title, script ID, creating user, creation time, and other details. |\n| **Read project content** | [projects.getContent](/apps-script/api/reference/rest/v1/projects/getContent) **Results** : Returns an array of [`File`](/apps-script/api/reference/rest/v1/File) objects, one for each code and HTML file in the project. The list also includes the [project manifest](/apps-script/concepts/manifests) as a JSON file. File objects contain the source content of the file (`File.source`) and other metadata, such a list of functions in the file (`File.functionSet`). **Options** : You can specify which [version](/apps-script/guides/versions) of the content to retrieve with a query parameter. |\n| **Update project content** | [projects.updateContent](/apps-script/api/reference/rest/v1/projects/updateContent) **Results** : Changes the file content in a script project. You provide the new content as an array of [`File`](/apps-script/api/reference/rest/v1/File) objects. One of these `File` objects must have JSON type and represent the script project's new [project manifest](/apps-script/concepts/manifests). The new content is stored as the HEAD version of the project. It is used when the script executes as a trigger, in the script editor, in add-on preview mode, or as a web app or Apps Script API in development mode. **Note** : When updating script project content, common practice is to first issue a [projects.getContent](/apps-script/api/reference/rest/v1/projects/getContent) request to retrieve an array of the existing `File`s, make the desire to those objects, then use the `File`s as input for a [projects.updateContent](/apps-script/api/reference/rest/v1/projects/updateContent) request. **Warning:** The new content replaces all existing files in the script project. Files not updated by the request are removed. |\n| **Read project metrics** | [projects.getMetrics](/apps-script/api/reference/rest/v1/projects/getMetrics) **Results** : Read certain metrics about a project. These metrics include the number of users, the total number of executions, the total number of execution errors, and other details. Use a [MetricType](/apps-script/api/reference/rest/v1/projects/getMetrics#metrictype) to specify the information you are requesting. **Options** : Restrict the results to specific deployments or script functions using a [MetricsFilter](/apps-script/api/reference/rest/v1/projects/getMetrics#MetricsFilter). You can also define a specific metric interval using a [MetricsIntervalConfig](/api/reference/rest/v1/projects/getMetrics#metricsintervalconfig). |"]]
