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, bei Bedarf Eingabeparameter bereitstellen und eine Antwort empfangen.

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

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

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

Funktion ausführen

Mit der folgenden scripts.run-Anfrage wird eine Apps Script-Funktion namens listFolderContent aufgerufen und ihr werden die Google Drive-ID folderId und die 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 wird unten angezeigt. Im Leitfaden Funktionen ausführen wird beschrieben, wie Sie eine Ausführungsanfrage in verschiedenen Sprachen mit den Google API-Clientbibliotheken 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 mit Dateinamen zurück:

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

Wenn bei der Ausführung von Apps Script 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
        }]
      }]
    }
  }
}