Projekte verwalten
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
In diesem Abschnitt finden Sie einen Überblick über die Apps Script API-Methoden, mit denen Sie Ihre Apps Script-Projekte erstellen, lesen, ändern und überwachen können. Auf der Seite Projektverwaltung finden Sie Beispiele für API-Verwaltungsanfragen. Die Referenzdokumentation für jede Methode enthält Implementierungsdetails.
| Übersicht über API-Methoden |
| Projekte erstellen |
projects.create
Ergebnisse: Erstellt ein einfaches, leeres Projekt ohne Projektdateien und mit einem Standard-Projektmanifest.
Optionen: Sie können einen Projekttitel angeben. Sie können auch ein gebundenes Skript erstellen, indem Sie die Google Drive-ID einer Google-Dokumente-, Google-Tabellen-, Google-Formulare- oder Google-Präsentationen-Datei angeben, die als übergeordnete Datei des Skripts dienen soll.
|
| Projektmetadaten lesen |
projects.get
Ergebnisse: Ruft ein
Project-Objekt ab, das Projektmetadaten darstellt. Diese Daten umfassen den Projekttitel, die Skript-ID, den Nutzer, der das Projekt erstellt hat, die Erstellungszeit und weitere Details.
|
| Projektinhalte lesen |
projects.getContent
Ergebnisse: Gibt ein Array von File-Objekten zurück, eines für jede Code- und HTML-Datei im Projekt. Die Liste enthält auch das Projektmanifest als JSON-Datei. Dateiobjekte enthalten den Quellinhalt der Datei (File.source) und andere Metadaten, z. B. eine Liste der Funktionen in der Datei (File.functionSet).
Optionen: Sie können mit einem Abfrageparameter angeben, welche Version der Inhalte abgerufen werden soll.
|
| Projektinhalte aktualisieren |
projects.updateContent
Ergebnisse: Ändert den Dateiinhalt in einem Skriptprojekt.
Sie geben die neuen Inhalte als Array von File-Objekten an. Eines dieser File-Objekte muss den JSON-Typ haben und das neue Projektmanifest des Skriptprojekts darstellen. Die neuen Inhalte werden als HEAD-Version des Projekts gespeichert. Wird verwendet, wenn das Skript als Trigger, im Script-Editor, im Add-on-Vorschaumodus oder als Web-App oder Apps Script API im Entwicklermodus ausgeführt wird.
Hinweis: Wenn Sie den Inhalt eines Skriptprojekts aktualisieren, ist es üblich, zuerst eine
projects.getContent-Anfrage zu senden, um ein Array der vorhandenen Files abzurufen. Nehmen Sie dann die gewünschten Änderungen an diesen Objekten vor und verwenden Sie die Files als Eingabe für eine
projects.updateContent-Anfrage.
Warnung:Der neue Inhalt ersetzt alle vorhandenen Dateien im Skriptprojekt. Dateien, die durch die Anfrage nicht aktualisiert werden, werden entfernt.
|
| Projektmesswerte lesen |
projects.getMetrics
Ergebnisse: Bestimmte Messwerte zu einem Projekt lesen.
Diese Messwerte umfassen die Anzahl der Nutzer, die Gesamtzahl der Ausführungen, die Gesamtzahl der Ausführungsfehler und andere Details.
Verwenden Sie einen
MetricType, um die angeforderten Informationen anzugeben.
Optionen: Beschränken Sie die Ergebnisse mit einem
MetricsFilter auf bestimmte Bereitstellungen oder Skriptfunktionen.
Sie können auch ein bestimmtes Messwertintervall mit einer
MetricsIntervalConfig definieren.
|
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-31 (UTC).
[null,null,["Zuletzt aktualisiert: 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). |"]]
