Criar e gerenciar implantações

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Uma implantação de projeto do Apps Script é uma versão do script disponibilizada para uso como um app da Web, um complemento ou um executável de API. Ao criar e gerenciar implantações, você pode iterar no seu código, acompanhar as 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 sempre são sincronizadas com o código do projeto atual
  • Implantações com controle de versões, que estã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 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 do cabeçalho refletirá essas alterações, enquanto a implantação com versão permanecerá inativa.

Use as implantações principais para testar o código. Não use implantações principais para uso público.

Implantações com versão

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 mudanças e melhorias no código.

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

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 versão existentes no projeto não mudará. Se um administrador excluir a conta do proprietário da implantação, poderá ocorrer erros de script nas implantações.

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

Se você quiser implantar o script como um complemento 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.
  5. Insira as informações sobre a implantação e clique em Implantar.

Ver 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.

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

É possível editar uma implantação com controle de versões para alterar o nome ou a versão. Para editar uma implantação, siga estas etapas:

  1. Abra o projeto do Apps Script.
  2. No canto superior direito, clique em Implantar > Gerenciar implantações.
  3. Selecione a implantação ativa que você quer alterar e clique em Editar .
  4. Faça suas mudanças e clique em Implantar.

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

    Para 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.

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 Arquivados, selecione a implantação que você quer reimplantar e clique em Editar > Implantar.

Encontrar um ID de implantação

Cada implantação tem um ID de string associado automaticamente criado 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.

    Os IDs de implantação só aparecem em implantações ativas.

Testar uma implantação

A forma de testar a implantação depende do tipo de app que você cria.

Complemento do Google Workspace

Para testar uma implantação de Complementos do Google Workspace, consulte Testar complementos do Google Workspace.

Complemento de editor

Veja como testar uma implantação de Complementos de editor em Testar um complemento do Editor.

App da Web

Para testar a implantação de um aplicativo da Web, consulte Testar uma implantação de aplicativo da Web.

App Chat

Para testar uma implantação de aplicativo de bate-papo, você precisa primeiro criar uma implantação com versão do script para acessar seu ID de implantação.

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

API executável

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:

  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" > API Executável.
  3. Copie e use o URL para testar a implantação do executável da API.

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

No ambiente de desenvolvimento integrado mais recente, é possível arquivar somente implantações, não excluí-las.

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