Projektmanagement

Mit der Google Apps Script API können Sie Google Apps Script-Projekte in Ihrer App erstellen und ändern. Die Beispiele auf dieser Seite veranschaulichen, wie gängige Projektverwaltungsaufgaben mit der API ausgeführt werden können.

Damit Sie die API verwenden können, müssen Sie sie zuerst aktivieren.

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.

Neues Apps Script-Projekt erstellen

Mit der folgenden projects.create-Anfrage wird ein neues eigenständiges Skript 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 wie 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 Skriptprojekts abgerufen, einschließlich des Quellcodes und der Metadaten für jede Skriptdatei.

GET https://scriptmanagement.googleapis.com/v1/projects/scriptId/content

Die Antwort besteht aus einem Content-Objekt wie 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 Skriptprojekts aktualisiert. Diese Inhalte werden als HEAD-Version gespeichert und verwendet, wenn das Skript 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 wie 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"
  }]
}