Zarządzanie projektami

Interfejs Apps Script API umożliwia tworzenie i modyfikowanie projektów Apps Script z aplikacji. Przykłady na tej stronie pokazują, jak można wykonywać za pomocą interfejsu API niektóre typowe operacje zarządzania projektami.

UWAGA: przed użyciem interfejsu Apps Script API musisz go włączyć.

W tych przykładach obiekt zastępczy scriptId wskazuje, gdzie należy podać identyfikator projektu skryptu. Aby znaleźć identyfikator skryptu, wykonaj te czynności:

  1. W lewym górnym rogu projektu Apps Script kliknij Ustawienia projektu .
  2. Obok opcji „Identyfikator skryptu” kliknij Kopiuj.

Tworzenie nowego projektu Apps Script

Poniższe żądanie projects.create tworzy nowy samodzielny skrypt.

POST https://scriptmanagement.googleapis.com/v1/projects/
{
  "title": "My Script"
}

Pobieranie metadanych projektu

Poniższe żądanie projects.get pobiera metadane projektu skryptu.

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

Odpowiedź składa się z obiektu, takiego jak ten:

{
  "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" },
}

Pobieranie plików projektu

Poniższe żądanie projects.getContent pobiera zawartość projektu skryptu, w tym źródło kodu i metadane każdego pliku skryptu.

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

Odpowiedź zawiera obiekt Content, na przykład:

{
  "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"
  }]
}

Aktualizowanie plików projektu

Żądanie projects.updateContent aktualizuje zawartość określonego projektu skryptu. Te treści są przechowywane jako wersja HEAD i służą do wykonania skryptu jako projektu interfejsu API.

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"
  }]
}

Odpowiedź zawiera obiekt Content, na przykład:

{
  "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"
  }]
}