Einführung

Mit der Google Apps Script API können Sie die Erstellung, Verwaltung und Ausführung 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. Diese Aktionen erfordern andernfalls die Verwendung des Apps Script-Editors oder seiner Benutzeroberfläche.

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
  • Ausführungsprotokolle und Status von Skripts überwachen

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 aktivieren.

Wenn andere Apps Ihre Skripts verwalten dürfen, 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 haben und eine Reihe von Anfragen enthalten, 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 Skriptprojektbereitstellungen. Mit Bereitstellungen können Sie Ihr Skript als Webanwendung, Add-on oder ausführbare Datei zur Verfügung stellen.
  • projects.versions : Eine Darstellung einer Skriptprojektversion. Die API bietet Methoden zum Erstellen und Lesen von Projektversionen. Mit Versionen können Sie verschiedene Iterationen Ihres Skriptprojekts verfolgen.
  • 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 Skriptausführungen überwachen, die mit der Methode scripts.run initiiert wurden.
  • scripts : Der Endpunkt, der Methoden zum Remote-Ausführen von Apps Script-Funktionen bietet. Mit dieser Ressource können Sie Funktionen in Ihrem Skriptprojekt über Ihre Anwendung ausführen.