Comece a usar o CLASP: Configuração fácil do Google Apps Script

Observação: Esta postagem foi publicada originalmente em nosso fórum da comunidade.

Deseja turbinar seu desenvolvimento do Google Apps Script? Conheça o CLASP-Command Line Apps Script, a ferramenta que permite escrever e gerenciar seus projetos do Google Apps Script localmente no seu computador, com o poder do controle de versão e práticas modernas de desenvolvimento.

Neste guia rápido, vamos orientá-lo nas etapas para colocar o CLASP em funcionamento, para que você possa começar a programar como um profissional em pouco tempo!

Etapa 1: Instalar o Node.js e o NPM

Antes de instalar o CLASP, você precisa ter o Node.js e o NPM (Node Package Manager) instalados em seu computador.

1. Faça download e instale o Node.js

• Ir para oSite oficial do Node.jse faça o download da versão estável mais recente para seu sistema operacional.
• Siga as instruções de instalação e certifique-se de que o NPM esteja instalado junto com o Node.js. O NPM geralmente vem junto com o Node.js, portanto você deve estar pronto quando a instalação for concluída.

2. Verificar a instalação

• Abra sua interface de linha de comando (CLI) e digite os seguintes comandos para verificar se o Node.js e o NPM estão instalados: bashnode -v npm -v

• Se instalados corretamente, ambos os comandos devem retornar números de versão.

Etapa 2: Instalar o CLASP

Agora que o Node.js e o NPM estão instalados, você pode instalar o CLASP globalmente em seu computador.

1. Instalar o CLASP

• Em sua CLI, digite o seguinte comando: bash npm install -g @google/clasp
• Esse comando instala o CLASP globalmente, permitindo que você o use em qualquer lugar do seu sistema.

2. Verificar a instalação

• Para confirmar que o CLASP está instalado corretamente, execute o seguinte comando: bash clasp -v
• Você deverá ver o número da versão do CLASP, indicando que a instalação foi bem-sucedida.

Etapa 3: Configurar o projeto de script do Google Apps

Agora que o CLASP está instalado, você pode configurar seu projeto do Google Apps Script.

1. Autenticar o CLASP com sua conta do Google

• Execute o seguinte comando para fazer login com sua conta do Google: bash clasp login
• Isso abrirá uma janela do navegador solicitando que você autentique o CLASP com sua conta do Google. Siga as instruções para permitir o acesso.

2. Criar um novo projeto de script do Google Apps

• Para criar um novo projeto, navegue até o diretório desejado na CLI e execute: bash clasp create -title “My New Project” -type standalone
• Substitua `“My New Project”` pelo nome do projeto desejado. O sinalizador `-type standalone` indica que esse é um script autônomo, não vinculado a nenhum documento, planilha ou formulário do Google em particular.

3. Extrair um projeto existente do Google Apps Script (opcional)

• Se você já tiver um projeto do Google Apps Script e quiser trabalhar nele localmente, use: bash clasp clone YOUR_SCRIPT_ID
• Substitua `YOUR_SCRIPT_ID` pelo ID do script de seu projeto. Isso puxa o projeto para seu computador local.

Etapa 4: Comece a codificar e a fazer alterações

Com seu projeto configurado, você pode começar a programar localmente e enviar suas alterações para o Google Apps Script.

1. Escreva seu código localmente

• Use seu editor de código favorito (como o VS Code) para escrever o código do Apps Script. Os arquivos são normalmente salvos como arquivos `.gs` (Google Script) ou `.js` (JavaScript).

2. Enviar alterações para o script do Google Apps

• Depois de fazer alterações localmente, você pode enviá-las para o Google Apps Script executando: bash clasp push
• Esse comando carrega suas alterações locais no editor de scripts do Google Apps.

3. Extrair alterações do script do Google Apps

• Se você tiver feito alterações diretamente no editor de scripts do Google Apps, transfira essas alterações para seu ambiente local com: bash clasp pull
• Isso garante que seus arquivos locais estejam atualizados com as alterações mais recentes.

Etapa 5: implantar seu script

Quando estiver satisfeito com seu script, você poderá implantá-lo diretamente usando o CLASP.

1. Implantar como um aplicativo da Web

• Para implantar seu script como um aplicativo da Web, use o seguinte comando: bash clasp deploy -description “Initial deployment”
• Isso implementa a versão mais recente do seu script e fornece um URL de implementação.

2. Gerenciar implantações

• Para exibir todas as implantações ou atualizar uma implantação existente, use: bash clasp deployments
• Esse comando mostra todas as implantações ativas e seus URLs.

Conclusão

Com o CLASP, o gerenciamento de seus projetos do Google Apps Script se torna mais eficiente e dimensionável. Agora é possível aproveitar o controle de versão, os ambientes de desenvolvimento local e os processos de implementação contínuos. Quer esteja desenvolvendo um script complexo ou apenas começando, o CLASP é um divisor de águas para os desenvolvedores do Apps Script. Pronto para levar sua codificação para o próximo nível? Configure o CLASP hoje mesmo e comece a explorar as infinitas possibilidades!