Projekte verwalten

In diesem Abschnitt erhalten Sie einen Überblick über die Methoden der Apps Script API, mit denen Sie Apps Script-Projekte erstellen, lesen, ändern und überwachen können. Auf der Seite mit Beispielen für die Projektverwaltung finden Sie Beispiele für API-Verwaltungsanfragen. Die Referenzdokumentation für jede Methode enthält Implementierungsdetails.

API-Methoden – Übersicht
Projekte erstellen	projects.create Ergebnisse: Sie erstellen ein einfaches, leeres Projekt ohne Projektdateien und ein standardmäßiges Projektmanifest. Optionen: Sie können einen Projekttitel angeben. Sie können auch ein gebundenes Script erstellen, indem Sie die Google Drive-ID einer Google Docs-, Google Sheets-, Google Formulare- oder Google Präsentationen-Datei angeben, die als übergeordnetes Element des Scripts fungieren soll.
Projektmetadaten lesen	projects.get Ergebnisse: Hier wird ein Project-Objekt abgerufen, das Projektmetadaten darstellt. Dazu gehören der Projekttitel, die Script-ID, der Nutzer, der das Script erstellt hat, die Erstellungszeit und weitere Details.
Projektinhalte lesen	projects.getContent Ergebnisse: Gibt ein Array von File-Objekten zurück, jeweils 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: Mit einem Abfrageparameter kannst du angeben, welche Version der Inhalte abgerufen werden soll.
Projektinhalte aktualisieren	projects.updateContent Ergebnisse: Ändert den Dateiinhalt in einem Scriptprojekt. 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 Scriptprojekts darstellen. Die neuen Inhalte werden als HEAD-Version des Projekts gespeichert. Sie wird verwendet, wenn das Script als Trigger ausgeführt wird, im Script-Editor, im Add-on-Vorschaumodus oder als Webanwendung oder Apps Script API im Entwicklungsmodus. Hinweis: Beim Aktualisieren von Scriptprojektinhalten wird in der Regel zuerst eine projects.getContent-Anfrage gestellt, um ein Array der vorhandenen Files abzurufen. Anschließend werden die gewünschten Änderungen an diesen Objekten vorgenommen und die Files als Eingabe für eine projects.updateContent-Anfrage verwendet. Warnung:Der neue Inhalt ersetzt alle vorhandenen Dateien im Scriptprojekt. Dateien, die durch den Antrag nicht aktualisiert wurden, werden entfernt.
Projektmesswerte lesen	projects.getMetrics Ergebnisse: Bestimmte Messwerte zu einem Projekt abrufen. Dazu gehören die Anzahl der Nutzer, die Gesamtzahl der Ausführungen, die Gesamtzahl der Ausführungsfehler und weitere Details. Verwenden Sie einen Messwerttyp, um die angeforderten Informationen anzugeben. Optionen: Mit einem Messwertfilter können Sie die Ergebnisse auf bestimmte Bereitstellungen oder Scriptfunktionen beschränken. Sie können auch mit einer MetricsIntervalConfig ein bestimmtes Messwertintervall definieren.