Uma implantação de projeto do Google Apps Script é uma versão do script que está disponível para uso como um app da Web, complemento do Google Workspace ou executável de API. Ao criar e gerenciar implantações, você pode iterar no seu código, acompanhar as mudanças e controlar a versão do código que os usuários acessam.
Há dois tipos de implantações:
- Implantações principais, que sempre são sincronizadas com o código do projeto atual.
- Implantações com controle de versões, que se conectam a uma versão específica do projeto.
Implantações principais
Uma implantação principal é o código do projeto atual. Quando você cria um projeto do Apps Script, o sistema cria automaticamente uma implantação principal para ele.
A implantação principal sempre é sincronizada com o código salvo mais recentemente. Por exemplo, se você criar uma implantação com controle de versão e modificar o código, a implantação principal vai refletir essas mudanças, enquanto a implantação com controle de versão vai permanecer intacta.
Use implantações principais para testar o código. Não use implantações principais para uso público.
Há apenas uma implantação principal para cada projeto do Apps Script. Para usar uma implantação principal, é preciso ter pelo menos acesso de leitura ao projeto de script.
Implantações com controle de versões
Uma implantação com controle de versão disponibiliza uma versão específica do código do projeto. Isso permite que os usuários continuem usando uma versão funcional enquanto você faz mudanças e melhorias no código.
Ao publicar um aplicativo para uso público, sempre use uma implantação com controle de versões. É possível ter várias implantações com versões ativas ao mesmo tempo.
Importante: não é possível transferir a propriedade de implantações com controle de versões. Se você transferir a propriedade de um projeto de script, o proprietário das implantações versionadas atuais não vai mudar. Se um administrador excluir a conta do proprietário da implantação, as implantações poderão apresentar erros de script.
Criar uma implantação com controle de versões
Para implantar uma versão de um complemento, complemento do Editor, app de chat ou um executável de API, primeiro mude a associação do projeto do Google Cloud do Apps Script do projeto padrão para um projeto padrão.
Para criar uma implantação com controle de versão:
- Abra o projeto do Apps Script. <<../_common/snippets/create-new-deployment.md>>
Cada nova implantação pode ser compartilhada como uma biblioteca. Se você compartilhar o script como uma biblioteca, a descrição da implantação vai ficar visível para os usuários da biblioteca.
Ver implantações versionadas
Para ver as implantações de um projeto do Apps Script, clique em Implantar > Gerenciar implantações na parte de cima.
Para conferir o código de uma versão específica, consulte Ver uma versão anterior.
Editar uma implantação com controle de versões
É possível editar uma implantação com controle de versões para mudar a descrição ou a versão. Para editar uma implantação:
- Abra o projeto do Apps Script.
- Clique em Implantar > Gerenciar implantações.
- Selecione a implantação ativa e clique em Editar .
- Faça as mudanças e clique em Implantar.
Para editar uma implantação arquivada, reimplante-a e siga as etapas anteriores.
Para implantar uma mudança no código do projeto, crie uma nova versão e edite a implantação para usá-la. A implantação usa automaticamente a nova versão para todos os usuários.
Encontrar um ID de implantação
Cada implantação tem um ID de string associado. Para encontrar esse ID:
- Abra o projeto do Apps Script.
- No canto superior direito, clique em Implantar > Gerenciar implantações.
- Selecione uma implantação ativa para encontrar o ID dela.
Os IDs de implantação só aparecem em implantações ativas.
Testar uma implantação
O método para testar uma implantação depende do tipo de app que você cria.
Complemento do Google Workspace
Para testar uma implantação de complemento, consulte Como testar complementos.
Complemento do Editor
Para testar a implantação de um complemento do editor, consulte Testar um complemento do editor.
Web app
Para testar uma implantação de app da Web, consulte Testar uma implantação de app da Web.
App Google Chat
Para testar uma implantação de app de chat, crie uma implantação com versão do script para acessar o ID de implantação dele.
Depois de ter o ID de implantação, especifique-o na configuração da API Chat e siga as etapas para testar recursos interativos.
Executável da API
Para testar uma implantação executável de API, crie uma implantação com controle de versões. Depois de criar uma implantação, siga estas etapas:
- No canto superior direito do projeto do Apps Script, clique em Implantar > Testar implantações.
- Ao lado de "Selecionar tipo", clique em
> Executável de API. - Copie e use o URL para testar a implantação do executável da API.
Arquivar uma implantação com controle de versão
Não é possível excluir implantações com controle de versões. Em vez disso, você pode arquivar.
Para arquivar uma implantação versionada:
- Abra o projeto do Apps Script.
- Clique em Implantar > Gerenciar implantações.
- Selecione a implantação e clique em Arquivar implantação .
Reimplantar uma implantação arquivada
- Abra o projeto do Apps Script.
- No canto superior direito, clique em Implantar > Gerenciar implantações.
- Em Arquivados, selecione a implantação e clique em Editar > Implantar.