Publicar um complemento

Quando você publica um complemento, ele fica disponível para que outras pessoas possam encontrá-lo, instalá-lo e usá-lo.

Antes da publicação

Determinar seu público-alvo

Para que qualquer usuário encontre e instale o complemento, publique-o publicamente. Quando você publica o complemento, a equipe do Google o analisa antes de publicar no Google Workspace Marketplace.

Para limitar o complemento a usuários em um domínio específico, publique-o de forma privada. Quando você publica um complemento de forma privada no seu domínio, a equipe do Google não o analisa antes da publicação.

Aviso: depois de salvar a opção de visibilidade durante o processo de publicação, não será possível mudar a seleção. Confira a visibilidade necessária para seu complemento antes de iniciar o processo de publicação.

Analisar os requisitos de publicação de complementos

Revise os requisitos de publicação do complemento para o tipo de complemento e verifique se ele atende a todos eles. Consulte Áreas de revisão.

Observação: mesmo que você planeje publicar de forma privada no seu domínio, verifique se o complemento atende aos requisitos de publicação. É importante oferecer uma experiência ótima para seus usuários.

Verificar o acesso do colaborador

O projeto do Apps Script do seu complemento é de uma conta de usuário único (geralmente sua conta) ou de um drive compartilhado. Para publicar o complemento, um colaborador do script precisa atuar como editor, o que inclui criar um projeto padrão do Google Cloud.

Para publicar o complemento, você precisa ter acesso de edição ao projeto do script. Se você não for o proprietário do projeto do script, sua conta do Workspace precisa pertencer ao mesmo domínio que o proprietário do projeto.

Para verificar o acesso do colaborador, consulte a visão geral de Como criar complementos do Google Workspace.

Testar o complemento

Verifique se o complemento está totalmente funcional e não é um trabalho em andamento.

Para fins de teste, é possível instalar complementos não publicados (também chamados de complementos para desenvolvedores). Para compartilhar complementos não publicados com outras pessoas, compartilhe o projeto do Apps Script.

• Para complementos do Google Workspace, consulte Testar complementos do Google Workspace.
• Para complementos do editor, consulte Complementos do editor de testes.

Criar uma versão do complemento

Crie uma versão do seu complemento e registre o número da versão. Uma versão é um snapshot do código usado pelo complemento publicado.

• Se você publicar um complemento do Editor, use o número da versão ao configurar o SDK do Google Workspace Marketplace.
• Se você publicar um complemento do Google Workspace, use o ID de implantação da versão que quer publicar.

Se o complemento usar uma biblioteca do Apps Script, você também vai precisar criar e usar uma versão do projeto de script da biblioteca. Para mais informações, consulte Bibliotecas.

Criar um projeto padrão do Google Cloud

Quando você cria um complemento no Apps Script, um projeto padrão do Google Cloud é criado automaticamente para ele. No entanto, não é possível usar o projeto padrão do Google Cloud para publicar o app. Siga as etapas abaixo para criar um projeto padrão do Google Cloud:

1. Abra a lista de projetos do Console de APIs do Google.
2. Clique em Criar projeto.
3. Preencha as informações do projeto do seu complemento.
4. Clique em Criar.

Depois de criar o projeto padrão do Google Cloud, mude o projeto do AppsScript do projeto padrão do Google Cloud para o projeto padrão do Google Cloud.

Publicar o complemento

Quando estiver tudo pronto para publicar o complemento, siga as etapas para publicar um app no Google Workspace Marketplace. Consulte Como publicar.