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:
- W lewym górnym rogu projektu Apps Script kliknij Ustawienia projektu .
- 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" }] }