A API Apps Script permite criar e modificar projetos do Apps Script no seu app. Os exemplos desta página ilustram como algumas operações comuns de gerenciamento de projetos podem ser realizadas com a API.
OBSERVAÇÃO: a API Apps Script precisa ser ativada antes do uso.
Nesses exemplos, os marcadores de posição scriptId são usados para indicar onde você forneceria o ID do projeto do script. Siga as etapas abaixo para encontrar o ID do script:
- No projeto do Apps Script, no canto superior esquerdo, clique em Configurações do projeto .
- Ao lado de "ID do script", clique em Copiar.
Criar um novo projeto do Apps Script
A solicitação projects.create a seguir cria um novo script independente.
POST https://scriptmanagement.googleapis.com/v1/projects/
{
"title": "My Script"
}Extrair metadados do projeto
A solicitação projects.get abaixo recebe os metadados do projeto do script.
GET https://scriptmanagement.googleapis.com/v1/projects/scriptId
A resposta consiste em um objeto como este:
{
"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" },
}Recuperar arquivos do projeto
A solicitação projects.getContent a seguir recebe o conteúdo do projeto de script, incluindo a origem do código e os metadados de cada arquivo de script.
GET https://scriptmanagement.googleapis.com/v1/projects/scriptId /content
A resposta consiste em um objeto Content como este:
{ "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" }] }
Atualizar arquivos do projeto
A solicitação projects.updateContent a seguir atualiza o conteúdo do projeto de script especificado. Esse conteúdo é armazenado como a versão HEAD e é usado quando o script é executado como um projeto executável de 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" }] }
A resposta consiste em um objeto Content como este:
{ "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" }] }