Esta página foi traduzida pela API Cloud Translation.

Usar a interface de linha de comando com a clasp

Para desenvolver e gerenciar projetos do Apps Script pelo seu terminal, e não pelo editor do Apps Script, use uma ferramenta de código aberto chamada clasp.

O codelab clasp (link em inglês) oferece uma visão geral de todos os recursos do clasp.

Recursos

Desenvolva localmente

clasp permite desenvolver seus projetos do Apps Script localmente. Escreva o código no seu computador e faça upload dele para o Apps Script quando terminar. Também é possível fazer o download de projetos existentes do Apps Script para editá-los off-line. Como o código é local, você pode usar suas ferramentas de desenvolvimento favoritas, como o git, ao criar projetos do Apps Script.

Gerenciar versões de implantação

Criar, atualizar e visualizar as várias implantações do projeto.

Código da estrutura

clasp permite que você organize seu código em diretórios, que são preservados quando você faz upload deles para script.google.com. Por exemplo:

# On script.google.com:
├── tests/slides.gs
└── tests/sheets.gs

# Locally:
├── tests/
│   ├─ slides.gs
│   └─ sheets.gs

Requisitos

clasp é escrito em Node.js e distribuído por meio da ferramenta npm. Antes de usar o clasp, você precisa ter o Node.js versão 4.7.4 ou posterior instalado. A instalação do Node.js requer privilégios de administrador.

Instalação

Depois de instalar o Node.js, use o seguinte comando npm para instalar o clasp:

npm install @google/clasp -g

Após a instalação, use o comando clasp em qualquer diretório no seu computador.

Como usar o `clasp`

Você pode usar clasp para processar várias tarefas na linha de comando. Esta seção descreve operações comuns que podem ser usadas ao desenvolver com clasp.

Esse comando faz login e autoriza o gerenciamento dos projetos do Apps Script da sua Conta do Google. Depois da execução, você precisa fazer login na Conta do Google que armazena seus projetos do Apps Script.

clasp login

Logout

Esse comando sai da ferramenta de linha de comando. Você precisa fazer um novo login usando clasp login para se autenticar outra vez com o Google antes de continuar usando clasp.

clasp logout

Criar um novo projeto do Apps Script

Esse comando cria um novo script no diretório atual com um título opcional.

clasp create [scriptTitle]

Este comando também cria dois arquivos no diretório atual:

Um arquivo .clasp.json que armazena o ID do script.
Um arquivo de manifesto do projeto appsscript.json contendo os metadados do projeto.

Clone um projeto

Esse comando clona um projeto no diretório atual. O script precisa ser criado ou compartilhado com sua Conta do Google. Para especificar o projeto de script a ser clonado, informe o ID do script.

Para encontrar o ID do script do projeto, siga as etapas abaixo:

Abra o projeto do Apps Script.
À esquerda, clique em Configurações do projeto .
Em IDs, copie o ID do script.
```
 clasp clone <scriptId>
```

Fazer o download de um projeto de script

Esse comando faz o download do projeto do Apps Script do Google Drive para o sistema de arquivos do seu computador.

clasp pull

Fazer upload de um projeto de script

Esse comando faz upload de todos os arquivos de um projeto de script do seu computador para o Google Drive.

clasp push

Listar versões do projeto

Esse comando lista o número e a descrição de cada uma das versões de um projeto de script.

clasp versions

Implantar um projeto publicado

É possível implantar projetos de script como apps da Web, complementos ou executáveis. Crie implantações no editor de script, no manifesto do projeto ou usando clasp.

Para implantar um projeto com clasp, primeiro crie uma versão imutável do projeto do Apps Script. Uma versão é um "snapshot" de um projeto de script e é semelhante a uma versão ramificada somente leitura.

clasp version [description]

Esse comando exibe o número da versão recém-criada. Usando esse número, é possível implantar e cancelar a implantação de instâncias do seu projeto:

clasp deploy [version] [description]
clasp undeploy <deploymentId>

Este comando atualiza uma implantação atual com uma nova versão e descrição:

clasp redeploy <deploymentId> <version> <description>

Listar implantações

Esse comando lista os códigos de implantação, as versões e as descrições do projeto de script.

clasp deployments

Abrir o projeto no editor do Apps Script

Esse comando abre um projeto de script no editor do Apps Script. O editor é aberto como uma nova guia no navegador da Web padrão.

clasp open

Contribua com o projeto de código aberto `clasp`

Contribua com clasp no GitHub.