Criar e gerenciar implantações

Uma implantação de projeto do Apps Script é uma versão do script disponibilizada para uso como app da Web, complemento ou executável da API. Ao criar e gerenciar implantações, você pode iterar no código, acompanhar as alterações 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 controle de versões, 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ê gera automaticamente uma implantação principal para ele.

A implantação principal está sempre sincronizada com o código salvo mais recentemente. Por exemplo, se você criar uma implantação com controle de versão e depois modificar seu código, a implantação principal refletirá essas alterações, enquanto a implantação com controle de versão permanecerá intacta.

Use as 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 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.

Quando o aplicativo for publicado para consumo público, use sempre uma implantação com controle de versão. É possível ter várias implantações ativas com controle de versão ao mesmo tempo.

Importante: não é possível transferir a propriedade de implantações com controle de versão. Se você transferir a propriedade de um projeto de script para alguém, o proprietário das implantações com controle de versão existentes no projeto não será alterado. Se um administrador excluir a conta do proprietário da implantação, talvez você encontre erros de script nas implantações.

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

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

  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 Ativar tipos de implantação .
  4. Selecione o tipo de implantação que você quer implantar. Para complementos do Google Workspace, Editores e apps do Google Chat, selecione Complemento.
  5. Insira as informações da implantação e clique em Implantar.

Conferir implantações com controle de versões

Para ver as implantações de um projeto do Apps Script, na parte superior, clique em Implantar > Gerenciar implantações.

Para ver o código de uma versão específica, consulte Acessar uma versão anterior.

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 editar uma implantação, siga estas etapas:

  1. Abra o projeto do Apps Script.
  2. Clique em Implantar > Gerenciar implantações.
  3. Selecione a implantação ativa que você quer alterar e clique em Editar .
  4. Faça as alterações e clique em Implantar.

    Se quiser editar uma implantação arquivada, você precisará reimplantá-la e seguir as etapas anteriores.

    Quando você quiser implantar uma alteração 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 utilizam essa implantação.

Encontrar um ID de implantação

Cada implantação tem um ID de string associado criado automaticamente para ela. Para encontrar esse ID, siga as etapas abaixo:

  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

A forma de testar uma implantação depende do tipo de aplicativo criado.

Complemento do Google Workspace

Para testar uma implantação de complementos do Google Workspace, consulte 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 do Chat, primeiro é necessário criar uma implantação com controle de versão do script para acessar o ID de implantação.

Quando você tiver o ID da implantação, siga as etapas para ativar a API Google Chat. Na página Configuração, em "Permissões", especifique apenas seu endereço de e-mail para instalar e testar o app.

Executável da API

Para testar uma implantação executável da API, é preciso primeiro criar uma implantação com controle de versão. Depois de criar uma implantação, siga as etapas abaixo:

  1. No canto superior direito do projeto do Apps Script, clique em Implantar > Implantações de teste.
  2. Ao lado de "Selecionar tipo", clique em Ativar tipos de implantação > Executável da API.
  3. 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á-los.

Para arquivar uma implantação com controle de versão:

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

Reimplantar uma implantação arquivada

  1. Abra o projeto do Apps Script.
  2. No canto superior direito, clique em Implantar > Gerenciar implantações.
  3. À esquerda, em Arquivado, selecione a implantação que você quer reimplantar e clique em Editar > Implantar.