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 zeigen, wie Sie mit der API gängige Projektverwaltungsaufgaben ausführen 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 Skript-Projekt-ID angeben müssen. 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.

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 Skript projekts 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. Dieser Inhalt wird 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"
  }]
}