Uma implantação de projeto do Apps Script é uma versão do script disponível para uso como app da Web, complemento ou executável de API. Ao criar e gerenciar implantações, você pode iterar em seu código, acompanhar suas alterações, e controlar a versão exata do código que os usuários podem acessar.
Há dois tipos de implantações:
- Implantações principais, que são sempre sincronizadas com o código do projeto atual.
- Implantações com controle de versão, 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 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. Para exemplo, se você criar uma implantação com controle de versão e depois modificar seu código, a implantação principal reflete essas alterações, enquanto a implantação com controle de versão permanece intactas.
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ão
Uma implantação com controle de versão disponibiliza uma versão específica do código do projeto. Isso permite que seus usuários continuem a usar uma versão funcional enquanto você mudanças e melhorias no código.
Quando seu aplicativo for publicado para consumo público, use sempre uma implantação com controle de versão. É possível ter várias implantações com controle de versões ativas uma vez.
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 para alguém, o proprietário do projeto as implantações com controle de versões no projeto não são alteradas. Se um administrador excluir a conta do proprietário da implantação, poderão ocorrer erros de script nos as implantações.
Criar uma implantação com controle de versão
Para implantar uma versão de um complemento do Google Workspace, faça o seguinte: Complemento do editor, app Google Chat ou API é preciso primeiro mudar o ambiente de execução Associação de projetos do Google Cloud do projeto padrão a um projeto padrão projeto.
Para criar uma implantação com controle de 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. Para Complementos do Google Workspace, Editores e nos apps do Google Chat, selecione Complemento.
Insira as informações sobre sua implantação e clique em Implantar.
Conferir implantações com controle de versão
Para acessar as implantações de um projeto do Apps Script, na parte de cima, Clique em Implantar > Gerenciar implantações.
Para visualizar o código de uma versão específica, consulte Visualizar uma versão versão.
Editar uma implantação com controle de versão
É possível editar uma implantação com controle de versão para alterar a descrição ou versão dela. Para 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 alterar e clique em "Editar" :
Faça as alterações e clique em Implantar.
Para editar uma implantação arquivada, reimplante-a e, em seguida, siga as etapas anteriores.
Quando você quiser implantar uma alteração no código do projeto, crie uma nova versão e e editar a implantação para usá-lo. A nova versão é usada automaticamente por qualquer usuários da implantação.
Encontrar um ID de implantação
Toda implantação tem um ID de string associado criado automaticamente para ela. 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 teste de uma implantação depende do tipo de app criado.
Complemento do Google Workspace
Para testar a implantação de um 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 a implantação de um app do Chat, primeiro você precisa criar uma implantação com controle de 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 teste interativo do Google Cloud.
Executável da API
Para testar uma implantação de API executável, primeiro você precisa criar uma implantação com controle de 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 controle de versão. Em vez disso, você pode arquivá-las.
Para arquivar uma implantação com controle de 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 Arquivadas, selecione a implantação que você quer reimplantar. e clique em Editar . > Implantar.