Mit der Apps Script API (früher Apps Script Execution API) können Sie um eine Funktion in einem Skriptprojekt, auf das Sie Zugriff haben, remote auszuführen. Ihr App eine bestimmte Apps Script-Funktion aufrufen und ihr Eingabeparameter zur Verfügung stellen, wenn und eine zurückgegebene Antwort erhalten.
Die Beispiele auf dieser Seite veranschaulichen, wie Sie mit einigen gängigen Ausführungsvorgängen die mit der API erreicht werden können. Weitere Informationen unter Autorisierungsanforderungen, finden Sie im Leitfaden Funktion ausführen.
In diesen Beispielen werden die Platzhalter scriptId wird verwendet, um anzugeben, wo Sie die Skript-Projekt-ID angeben würden. Folgen Sie um die Skript-ID zu finden:
- Klicken Sie im Apps Script-Projekt links oben auf Projekteinstellungen.
- Neben „Skript-ID“ Klicken Sie auf Kopieren.
Funktion ausführen
Die folgende scripts.run
Mit der Anfrage wird eine Apps Script-Funktion namens listFolderContent aufgerufen und
das Laufwerk folderId und eine Ganzzahl MAX_SIZE als Argumente. Die
wird im Entwicklungsmodus ausgeführt.
die gespeicherte Version der Funktion ausgeführt wird,
unabhängig davon, welche Version
die als ausführbare Datei bereitgestellt werden.
Das Anfrageprotokoll ist unten zu sehen. Die Leitfaden zur Ausführung von Funktionen zeigt, wie Sie eine Ausführungsanfrage in verschiedenen Sprachen mithilfe der Google API-Clientbibliotheken.
POST https://script.googleapis.com/v1/scripts/scriptId:run
{
"function": "listFolderContent",
"parameters": [
folderId,
MAX_SIZE
],
"devMode": true
}
Die Antwort die aufgerufene Apps Script-Funktion ausgeführt hat, enthält die Ergebnisse der Ausführung oder eine Fehlerantwort. In In diesem Beispiel gibt die Funktion erfolgreich ein Array von Dateinamen zurück:
{
"response": {
"result": [
"fileTitle1",
"fileTitle2",
"fileTitle3"
]
},
}
Wenn bei der Ausführung von Apps Script ein Fehler aufgetreten ist, könnte die Antwort wie folgt 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
}]
}]
}
}
}