Projekte verwalten

In diesem Abschnitt erhalten Sie einen Überblick über die Apps Script API-Methoden, mit denen Sie Ihre Apps Script-Projekte erstellen, lesen, ändern und überwachen können. Die Beispielseite für die Projektverwaltung enthält Beispiele für API-Verwaltungsanfragen. In der Referenzdokumentation zu den einzelnen Methoden finden Sie Details zur Implementierung.

Übersicht über API-Methoden
Projekte erstellen	projects.create Ergebnisse: Erstellen Sie ein einfaches, leeres Projekt ohne Projektdateien und ein standardmäßiges Projektmanifest. Optionen: Sie können einen Projekttitel angeben. Sie können auch ein gebundenes Skript erstellen. Geben Sie dazu die Google Drive-ID einer Google Docs-, Google Tabellen-, Google Formulare- oder Google Präsentationen-Datei an, die als übergeordnetes Skript verwendet werden soll.
Projektmetadaten lesen	projects.get Ergebnisse: Ruft ein Project-Objekt ab, das Projektmetadaten darstellt. Zu diesen Daten gehören der Projekttitel, die Skript-ID, der Erstellungsnutzer, der Erstellungszeitpunkt und andere Details.
Projektinhalte lesen	projects.getContent Ergebnisse: Gibt ein Array von File-Objekten zurück, eines für jeden Code und jede 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 von Funktionen in der Datei (File.functionSet). Optionen: Mit einem Abfrageparameter können Sie angeben, welche Version des Inhalts abgerufen werden soll.
Projektinhalte aktualisieren	projects.updateContent Ergebnisse: Ändert den Dateiinhalt in einem Skriptprojekt. Du stellst den neuen Inhalt als Array von File-Objekten bereit. Eines dieser File-Objekte muss den JSON-Typ haben und das neue Projektmanifest des Skriptprojekts darstellen. Der neue Inhalt wird als HEAD-Version des Projekts gespeichert. Sie wird verwendet, wenn das Skript als Trigger, im Skripteditor, im Add-on-Vorschaumodus oder als Webanwendung oder Apps Script API im Entwicklungsmodus ausgeführt wird. Hinweis: Wenn Sie Skriptprojektinhalte aktualisieren, empfiehlt es sich, zuerst eine projects.getContent-Anfrage zu senden, um ein Array der vorhandenen Files abzurufen, diese Objekte abzurufen und dann die Files als Eingabe für eine projects.updateContent-Anfrage zu verwenden. Warnung:Durch den neuen Inhalt werden alle vorhandenen Dateien im Skriptprojekt ersetzt. Dateien, die nicht durch die Anfrage aktualisiert wurden, werden entfernt.
Projektmesswerte lesen	projects.getMetrics Ergebnisse: Bestimmte Messwerte zu einem Projekt lesen. Zu diesen Messwerten gehören 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: Schränken Sie die Ergebnisse mithilfe eines MetricsFilter auf bestimmte Bereitstellungen oder Skriptfunktionen ein. Mit MetricsIntervalConfig können Sie auch ein bestimmtes Messwertintervall definieren.