Mit der Apps Script API können Sie Apps Script-Projekte direkt in Ihrer App erstellen und ändern. Die Beispiele auf dieser Seite veranschaulichen, wie Sie mit der API einige gängige Projektverwaltungsvorgänge ausführen können.
HINWEIS: Die Apps Script API muss vor der Verwendung aktiviert werden.
In diesen Beispielen gibt der Platzhalter scriptId an, wo Sie die Script-Projekt-ID angeben würden. So finden Sie die Script-ID:
- Klicken Sie im Apps Script-Projekt links oben auf Projekteinstellungen .
- Klicken Sie neben „Script-ID“ auf Kopieren.
Neues Apps Script-Projekt erstellen
Mit der folgenden projects.create-Anfrage wird ein neues eigenständiges Script erstellt.
POST https://scriptmanagement.googleapis.com/v1/projects/
{
"title": "My Script"
}Projektmetadaten abrufen
Mit der folgenden projects.get-Anfrage werden die Metadaten des Scriptprojekts abgerufen.
GET https://scriptmanagement.googleapis.com/v1/projects/scriptId
Die Antwort besteht aus einem Objekt, z. B. diesem:
{
"scriptId": "scriptId",
"title": "My Title",
"parentId": "parentId",
"createTime": "2017-10-02T15:01:23.045123456Z",
"updateTime": "2017-10-02T15:01:23.045123456Z",
"creator": { "name": "Grant" },
"lastModifyUser": { "name": "Grant" },
}Projektdateien abrufen
Mit der folgenden projects.getContent-Anfrage wird der Inhalt des Scriptprojekts abgerufen, einschließlich der Codequelle und der Metadaten für jede Scriptdatei.
GET https://scriptmanagement.googleapis.com/v1/projects/scriptId /content
Die Antwort besteht aus einem Content-Objekt, z. B. diesem:
{ "scriptId": "scriptId", "files": [{ "name": "My Script", "type": "SERVER_JS", "source": "function hello(){\nconsole.log('Hello world');}", "lastModifyUser": { "name": "Grant", "email": "grant@example.com", }, "createTime": "2017-10-02T15:01:23.045123456Z", "updateTime": "2017-10-02T15:01:23.045123456Z", "functionSet": { "values": [ "name": "helloWorld" ] } }, { "name": "appsscript", "type": "JSON", "source": "{\"timeZone\":\"America/New_York\",\"exceptionLogging\":\"CLOUD\"}", "lastModifyUser": { "name": "Grant", "email": "grant@example.com", }, "createTime": "2017-10-02T15:01:23.045123456Z", "updateTime": "2017-10-02T15:01:23.045123456Z" }] }
Projektdateien aktualisieren
Mit der folgenden projects.updateContent-Anfrage wird der Inhalt des angegebenen Scriptprojekts aktualisiert. Dieser Inhalt wird als HEAD-Version gespeichert und verwendet, wenn das Script als ausführbares API-Projekt ausgeführt wird.
PUT https://scriptmanagement.googleapis.com/v1/projects/scriptID /content
{ "files": [{ "name": "index", "type": "HTML", "source": "<html> <header><title>HTML Page</title></header> <body> My HTML </body> </html>" }, { "name": "My Script", "type": "SERVER_JS", "source": "function hello(){\nconsole.log('Hello world');}", }, { "name": "appsscript", "type": "JSON", "source": "{\"timeZone\":\"America/New_York\",\"exceptionLogging\":\"CLOUD\"}", "lastModifyUser": { "name": "Grant", "email": "grant@example.com", }, "createTime": "2017-10-02T15:01:23.045123456Z", "updateTime": "2017-10-02T15:01:23.045123456Z" }] }
Die Antwort besteht aus einem Content-Objekt, z. B. diesem:
{ "scriptId": "scriptId", "files": [{ "name": "index", "type": "HTML", "source": "<html> <header><title>HTML Page</title></header> <body> My HTML </body> </html>", "lastModifyUser": { "name": "Grant", "email": "grant@example.com", }, "createTime": "2017-10-02T15:01:23.045123456Z", "updateTime": "2017-10-02T15:01:23.045123456Z" }, { "name": "My Script", "type": "SERVER_JS", "source": "function hello(){\nconsole.log('Hello world');}", "lastModifyUser": { "name": "Grant", "email": "grant@example.com", }, "createTime": "2017-10-02T15:01:23.045123456Z", "updateTime": "2017-10-02T15:01:23.045123456Z", "functionSet": { "values": [ "name": "helloWorld" ] } }, { "name": "appsscript", "type": "JSON", "source": "{\"timeZone\":\"America/New_York\",\"exceptionLogging\":\"CLOUD\"}", "lastModifyUser": { "name": "Grant", "email": "grant@example.com", }, "createTime": "2017-10-02T15:01:23.045123456Z", "updateTime": "2017-10-02T15:01:23.045123456Z" }] }