Uma implantação de projeto do Apps Script é uma versão do script que é disponibilizada para uso como um app da Web, complemento ou executável de API. Ao criar e gerenciar implantações, você pode iterar o código, acompanhar as mudanças e controlar a versão exata do código a que os usuários têm acesso.
Há dois tipos de implantações:
- Implantações principais, que são sempre sincronizadas com o código do projeto atual.
- Implantações com versões, que são conectadas a uma versão específica do projeto.
Implantações principais
Uma implantação principal é o código do projeto atual. Ao criar um projeto do Apps Script, você cria automaticamente uma implantação principal para esse projeto.
A implantação principal está sempre sincronizada com o código salvo mais recentemente. Por exemplo, se você criar uma implantação com versão e modificar o código, a implantação principal vai refletir essas mudanças, enquanto a implantação com versão vai permanecer intacta.
Use implantações principais para testar o código. Não use implantações principais para uso público.
Implantações com controle de versões
Uma implantação com 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 alterações e melhorias no código.
Quando o aplicativo for publicado para uso público, sempre use uma implantação com versão. É possível ter várias implantações versionadas ativas ao mesmo tempo.
Importante: não é possível transferir a propriedade de implantações com versões. Se você transferir a propriedade de um projeto de script para alguém, o proprietário das implantações de versão atuais no projeto não vai mudar. Se um administrador excluir a conta do proprietário da implantação, você poderá encontrar erros de script nas implantações dele.
Criar uma implantação com versão
Para implantar uma versão de um complemento do Google Workspace, do Editor, do app Google Chat ou de 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 versão, siga estas etapas:
- Abra o projeto do Apps Script.
- No canto superior direito, clique em Implantar > Nova implantação.
- Ao lado de Selecionar tipo, clique em Ativar tipos de implantação .
- 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.
Insira as informações sobre a implantação e clique em Implantar.
Conferir implantações com versões
Para conferir as implantações de um projeto do Apps Script, na parte de cima, clique em Implantar > Gerenciar implantações.
Para conferir o código de uma versão específica, consulte Conferir uma versão anterior.
Editar uma implantação com versão
É possível editar uma implantação com versão para mudar a descrição ou a versão. Para editar uma implantação, siga estas etapas:
- Abra o projeto do Apps Script.
- Clique em Implantar > Gerenciar implantações.
- Selecione a implantação ativa que você quer mudar e clique em Editar .
Faça as mudanças e clique em Implantar.
Se você quiser editar uma implantação arquivada, será necessário reimplantá-la e seguir as etapas anteriores.
Quando você quiser implantar uma mudança no código do projeto, crie uma nova versão e edite a implantação para usá-la. A nova versão é usada automaticamente por todos os usuários que usam essa implantação.
Encontrar um ID de implantação
Cada implantação tem um ID de string associado criado automaticamente. Para encontrar esse ID, siga as etapas abaixo:
- 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
A forma de testar uma implantação depende do tipo de app que você cria.
Complemento do Google Workspace
Para testar uma implantação de complemento do Google Workspace, consulte Como testar complementos do Google Workspace.
Complemento do editor
Para testar uma implantação de complemento do Editor, consulte Testar um complemento do Editor.
App da Web
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, primeiro crie uma implantação com versão do script para acessar o ID de implantação.
Depois de ter o ID de implantação, especifique-o na configuração da API Chat e siga as etapas para testar recursos interativos.
API executável
Para testar uma implantação executável de API, primeiro crie uma implantação com versão. Depois de criar uma implantação, siga as etapas abaixo:
- No canto superior direito do projeto do Apps Script, clique em Implantar > Testar implantações.
- Ao lado de "Selecionar tipo", clique em "Ativar tipos de implantação"
> Executável da 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 versões. Em vez disso, você pode arquivá-los.
Para arquivar uma implantação com versão:
- Abra o projeto do Apps Script.
- Clique em Implantar > Gerenciar implantações.
- Selecione a implantação que você quer arquivar 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.
- À esquerda, em Arquivado, selecione a implantação que você quer reimplantar e clique em Editar > Implantar.