Projekte verwalten

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 mit Projektmanagement-Beispielen 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 File abzurufen. Nehmen Sie dann die gewünschten Änderungen an diesen Objekten vor und verwenden Sie die File 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.