Criar e gerenciar implantações

A implantação de um projeto do Google Apps Script é uma versão do seu 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, é possível iterar no código e controlar qual versão do script 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ões 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.

Implantações x versões

Uma versão e uma implantação são conceitos distintos no Apps Script:

• Versão: um instantâneo estático do código do projeto de script. Depois de criada, uma versão é imutável. Pense em uma versão como um "ponto de salvamento" no seu histórico de desenvolvimento.
• Implantação: um lançamento que disponibiliza uma versão específica do script para os usuários. Uma implantação tem um URL ou ID exclusivo.

Quando você quiser atualizar o código usado por uma implantação atual (como um app da Web), crie uma nova versão e edite a implantação para apontar para essa nova versão. Isso atualiza o aplicativo para todos os usuários, mantendo o mesmo URL ou ID de implantação.

Criar uma implantação com controle de versões

Para implantar uma versão de um complemento, complemento do Editor, app do 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:

1. Abra o projeto do Apps Script.
2. No canto superior direito, clique em Implantar > Nova implantação.
3. Ao lado de Selecionar tipo, clique em Habilitar tipos de implantação settings.
4. Selecione o tipo de implantação que você quer fazer. Para complementos do Google Workspace, complementos do editor e apps do Google Chat, selecione Complemento.
5. Insira as informações sobre sua implantação e clique em Implantar.

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:

1. Abra o projeto do Apps Script.
2. Clique em Implantar > Gerenciar implantações.
3. Selecione a implantação ativa e clique em Editar edit.
4. 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. Essa é a maneira padrão de atualizar o aplicativo sem mudar o URL ou o ID de implantação. 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:

1. Abra o projeto do Apps Script.
2. No canto superior direito, clique em Implantar > Gerenciar implantações.
3. 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.

Arquivar uma implantação com controle de versão

Não é possível excluir implantações versionadas do seu registro de implantações. Em vez disso, você pode arquivar.

Para arquivar uma implantação versionada:

1. Abra o projeto do Apps Script.
2. Clique em Implantar > Gerenciar implantações.
3. Selecione a implantação e clique em Arquivar implantação archive.

Excluir uma versão do histórico do projeto

Não é possível excluir implantações com controle de versões, mas é possível excluir as versões de script usadas por elas no histórico do projeto. Para excluir uma versão, ela não pode estar sendo usada por uma implantação ativa.

Para excluir uma versão, consulte Excluir versões.

Reimplantar uma implantação arquivada

1. Abra o projeto do Apps Script.
2. No canto superior direito, clique em Implantar > Gerenciar implantações.
3. Em Arquivado, selecione a implantação e clique em Editar edit > Implantar.