Projekte verwalten

In diesem Abschnitt finden Sie einen Überblick über die Google Apps Script API-Methoden, mit denen Sie Ihre Google Apps Script-Projekte erstellen, lesen, ändern und überwachen können. Auf der Beispielseite 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-Dokument-, 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 Ersteller, die Erstellungszeit und andere 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 stellen die neuen Inhalte als Array von File-Objekten bereit. 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. Sie wird verwendet, wenn das Skript als Trigger, im Script-Editor, im Vorschaumodus für Google Workspace-Add-ons oder als Web-App oder Apps Script API im Entwicklermodus ausgeführt wird. Hinweis: Wenn Sie den Inhalt eines Skriptprojekts aktualisieren möchten, stellen Sie zuerst eine projects.getContent-Anfrage, 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.