Google Apps Script-Funktionen ausführen

Mit der Google Apps Script API können Sie eine Funktion in einem Skriptprojekt, auf das Sie Zugriff haben, remote ausführen. Ihre App kann eine bestimmte Apps Script-Funktion aufrufen, ihr bei Bedarf Eingabeparameter übergeben und eine Antwort erhalten.

Die Beispiele auf dieser Seite veranschaulichen, wie gängige Ausführungsvorgänge mit der API ausgeführt werden können. Weitere Informationen, einschließlich besonderer Autorisierungsanforderungen, finden Sie im Leitfaden zum Ausführen einer Funktion.

In diesen Beispielen wird der Platzhalter scriptId verwendet, um anzugeben, wo Sie die Skript-Projekt-ID angeben. So finden Sie die Skript-ID:

  1. Klicken Sie im Apps Script-Projekt links oben auf Projekteinstellungen .
  2. Klicken Sie neben „Skript-ID“ auf Kopieren.

Funktion ausführen

Mit der folgenden scripts.run Anfrage wird eine Apps Script-Funktion namens listFolderContent aufgerufen und die Google Drive folderId und eine Ganzzahl MAX_SIZE als Argumente übergeben. Die Funktion wird im Entwicklermodus ausgeführt. Das bedeutet, dass die zuletzt gespeicherte Version der Funktion ausgeführt wird, unabhängig davon, welche Version als ausführbare Datei bereitgestellt wird.

Das Anfrageprotokoll ist unten dargestellt. Im Leitfaden zum Ausführen von Funktionen wird gezeigt, wie Sie eine Ausführungsanfrage in verschiedenen Sprachen mit den Google API-Client bibliotheken implementieren.

POST https://script.googleapis.com/v1/scripts/scriptId:run
 
{
  "function": "listFolderContent",
  "parameters": [
    folderId,
    MAX_SIZE
  ],
  "devMode": true
}

Die Antwort auf diese Anfrage enthält nach Abschluss der aufgerufenen Apps Script-Funktion die Ergebnisse der Ausführung oder eine Fehlermeldung. In diesem Beispiel gibt die Funktion erfolgreich ein Array von Dateinamen zurück:

{
  "response": {
    "result": [
      "fileTitle1",
      "fileTitle2",
      "fileTitle3"
    ]
  },
}

Wenn bei der Apps Script-Ausführung ein Fehler aufgetreten ist, könnte die Antwort so aussehen:

{
  "response": {
    "error": {
      "code": 3,
      "message": "ScriptError",
      "details": [{
        "@type": "type.googleapis.com/google.apps.script.v1.ExecutionError",
        "errorMessage": "The script enountered an exeception it could not resolve.",
        "errorType": "ScriptError",
        "scriptStackTraceElements": [{
          "function": "listFolderContent",
          "lineNumber": 14
        }]
      }]
    }
  }
}