Einführung

Mit der Google Apps Script API können Sie das Erstellen, Verwalten und Ausführen von Skripts in Google Apps Script automatisieren. Sie können Google Apps Script-Projekte programmatisch erstellen, ändern und bereitstellen sowie Apps Script-Funktionen remote ausführen. Für diese Aktionen ist normalerweise der Apps Script-Editor oder seine Benutzeroberfläche erforderlich.

Diese API wird häufig für Folgendes verwendet:

  • Apps Script-Projekte und -Bereitstellungen erstellen und verwalten
  • Funktionen in Skriptprojekten hinzufügen oder aktualisieren
  • Apps Script-Funktionen aus anderen Anwendungen ausführen
  • Überwachen Sie die Protokolle und Status der Scriptausführung.

Die Apps Script API ersetzt und erweitert auch die Apps Script Execution API. Mit der Apps Script API können Sie Apps Script-Funktionen remote ausführen, genau wie mit der Execution API.

Wenn Sie diese API in Ihren Apps verwenden möchten, müssen Sie sie für die Verwendung aktivieren.

Damit andere Apps Ihre Skripts verwalten können, müssen Sie ihnen Zugriff gewähren.

Übersicht über die API

Die Apps Script API ist in mehrere Ressourcen unterteilt, die jeweils einen bestimmten Zweck und eine Reihe von Anfragen haben, die Sie stellen können. Diese Ressourcen sind:

  • projects: Eine Darstellung eines Skriptprojekts. Die API bietet Methoden zum Erstellen, Lesen, Überwachen und Ändern von Projekten. Mit dieser Ressource können Sie die Skriptdateien und Metadaten Ihres Projekts verwalten.
  • projects.deployments: Eine Darstellung einer Skriptbereitstellung. Die API bietet Methoden zum Erstellen, Auflisten, Aktualisieren und Löschen von Bereitstellungen von Skriptprojekten. Mit Bereitstellungen können Sie Ihr Script als Web-App, Add-on oder ausführbare Datei verfügbar machen.
  • projects.versions – Eine Darstellung einer Version eines Skriptprojekts. Die API bietet Methoden zum Erstellen und Lesen von Projektversionen. Mit Versionen können Sie verschiedene Iterationen Ihres Skriptprojekts nachverfolgen.
  • processes: Eine Darstellung der Ausführung einer Skriptfunktion. Die API bietet Methoden zum Auflisten vorhandener Prozesse und zum Abrufen von Informationen zu diesen Prozessen, z. B. Typ und aktueller Status. Mit dieser Ressource können Sie Scriptausführungen überwachen, die mit der Methode scripts.run initiiert wurden.
  • scripts: Der Endpunkt, der Methoden zum Remote-Ausführen von Apps Script-Funktionen bereitstellt. Mit dieser Ressource können Sie Funktionen in Ihrem Skriptprojekt über Ihre Anwendung ausführen.