Configurar o app no SDK do Google Workspace Marketplace

Nesta página, explicamos como usar o SDK do Google Workspace Marketplace para configurar e gerenciar seu app no Google Workspace Marketplace.

Para disponibilizar o app para uso, é preciso configurá-lo no SDK do Google Workspace Marketplace. O SDK do Google Workspace Marketplace é um kit de ferramentas para criar e controlar o app no Google Workspace Marketplace. Use o SDK do Google Workspace Marketplace para gerenciar as configurações do Marketplace, como as seguintes:

  • Se o app está disponível para uma organização específica do Google Workspace (um app privado) ou para todos os usuários do Marketplace (um app público)
  • Os tipos de usuários do Marketplace que podem instalar o app
  • A quais aplicativos do Google Workspace seu app se integra
  • Os escopos OAuth exigidos pelo seu app
  • Informações sobre quem criou e mantém o app

Não importa se você está publicando seu app de forma pública ou particular, é necessário usar o SDK do Google Workspace Marketplace para gerenciar seu app no Marketplace.

Ativar o SDK do Google Workspace Marketplace

Ative o SDK do Google Workspace Marketplace no seu projeto do Google Cloud, caso ainda não tenha feito isso:

  1. Abra o Console do Google Cloud.
  2. Na parte de cima, clique em Selecionar um projeto. Se outro projeto do Google Cloud já estiver aberto, clique no nome do projeto do Cloud para alternar entre os projetos.
  3. Selecione o projeto do Cloud do seu app e clique em Abrir.
  4. Na parte de cima, na barra de pesquisa, digite Google Workspace Marketplace SDK e pressione Enter.

  5. Abra a página do SDK do Google Workspace Marketplace.

  6. Se o SDK do Google Workspace Marketplace ainda não estiver ativado, clique em Ativar.

Inserir as configurações do app no SDK do Google Workspace Marketplace

  1. Abra o SDK do Google Workspace Marketplace.
  2. Acesse a guia App Configuration.
  3. Preencha cada seção com as informações sobre seu app. Para saber mais sobre cada configuração, consulte a seção Configurações do app.
  4. Clique em Salvar.
  5. (Opcional) É possível receber análises sobre o uso do aplicativo no Google Analytics. Para fazer isso, adicione um ID do Google Analytics no SDK do Google Workspace Marketplace.
    1. Acesse a guia Analytics.
    2. Insira seu ID do Google Analytics.
    3. Clique em Salvar.

Configurações do app

A referência a seguir descreve as configurações disponíveis na página Configuração do app do SDK do Google Workspace Marketplace.

Visibilidade do app

Você verá a opção Visibilidade do app se estiver usando uma conta do Google Workspace (uma conta criada pela sua organização escolar ou de trabalho). Se você estiver usando uma conta pessoal (que termina com "@gmail.com"), só vai poder publicar publicamente.

  • Público: o app pode ser encontrado e instalado por pessoas fora do domínio. Se você escolher a visibilidade pública, o Google vai analisar e aprovar a página "Detalhes do app" antes da publicação.
  • Particular: somente pessoas dentro do seu domínio podem encontrar e instalar seu app.

Se você publicar como Não listado, os detalhes do app não serão exibidos na navegação nem nos resultados da pesquisa. Os usuários só podem acessar a página da loja do aplicativo com o URL direto.

Se você quiser limitar em quais países e regiões seu app está disponível, configure isso na seção Distribuição ao criar a página "Detalhes do app".

Configurações de instalação

As configurações de instalação determinam se os usuários ou administradores do Workspace podem instalar o app pela página "Detalhes do app" no Google Workspace Marketplace.

  • Instalação individual + administrador (padrão): o aplicativo pode ser instalado por usuários individuais ou por administradores em um domínio, uma unidade organizacional ou um grupo de usuários. As políticas de domínio do usuário podem impedir a instalação de um app, mesmo que as instalações individuais estejam ativadas.
  • Instalação somente pelo administrador: o aplicativo só pode ser instalado por administradores do domínio, da unidade organizacional ou de um grupo de usuários. Seu app só aparece nos resultados da pesquisa do Google Workspace Marketplace para administradores e pessoas que não fizeram login na Conta do Google. Escolha essa opção se o aplicativo exigir a instalação do domínio.

Integração de apps

Escolha os serviços do Google Workspace com que o app ou complemento foi projetado para funcionar, como um complemento do Google Workspace ou um app do Google Chat. Escolha pelo menos uma opção. Em alguns casos, você pode incluir várias integrações na página "Detalhes do app". Consulte Listar integrações de apps juntas.

Dependendo das integrações de apps escolhidas, talvez seja necessário fornecer mais informações e ativar as APIs relevantes no seu projeto do Google Cloud. A tabela a seguir descreve a configuração extra necessária para cada um:

Complemento do Google Workspace (Apps Script)

Para publicar um complemento do Google Workspace, forneça o ID de implantação dele. Para encontrar o ID da implantação, siga estas etapas:

  1. Abra seu complemento do Google Workspace no editor do Apps Script.
  2. Clique em Implantar > Gerenciar implantações.
  3. Abaixo do ID da implantação, clique em Copiar.

Complemento do Google Workspace (ambiente de execução alternativo)

Se você criou seu complemento do Google Workspace em uma linguagem de programação diferente do Google Apps Script, siga estas etapas para encontrar o ID de implantação do recurso de implantação do Google Cloud.

  1. Na página "Configuração do app", em "Complemento do Google Workspace", clique em Implantar usando o recurso de implantação na nuvem > Selecionar implantação.
  2. Selecione a implantação que você quer publicar.
  3. Clique em Selecionar.

Complemento do editor (Documentos, Planilhas, Apresentações, Formulários)

Para publicar um complemento do Editor, informe o ID do script do projeto e a versão que você quer publicar.

Para encontrar o ID do script do projeto, siga estas etapas:

  1. Abra o complemento no editor do Apps Script.
  2. À esquerda, clique em Configurações do projeto .
  3. Em "IDs", copie o ID do script.

Para encontrar a versão, siga estas etapas:

  1. Abra o complemento no editor do Apps Script.
  2. No canto superior direito, clique em Implantar > Gerenciar implantações.
  3. O número da versão está em "Configuração".

App Google Chat

Para publicar um app do Google Chat, você precisa configurar a API Google Chat. Consulte Publicar apps.

Aplicativo do Google Drive

Para publicar um app do Drive, você precisa ativar e configurar a API Drive.

App da Web

Para publicar um app da Web, é necessário fornecer o URL de navegação universal, o URL que aponta para o app da Web no menu de apps do Google . Seu app da Web precisa estar em produção e totalmente funcional.

Ao preencher a página "Detalhes do app", você precisa fornecer ícones adicionais de 96 x 96 e 48 x 48 pixels.

Se você criou seu app da Web no Apps Script, para ver o URL de navegação universal, siga estas etapas:

  1. Abra seu complemento do Google Workspace no editor do Apps Script.
  2. Clique em Implantar > Nova implantação.
  3. Em "Selecionar tipo", clique em App da Web.
  4. Preencha as opções e clique em Implantar.
  5. Clique em Copiar.

Escopos do OAuth

Envie uma lista completa dos escopos do OAuth exigidos pelo seu app. Os escopos do OAuth inseridos devem corresponder aos mostrados na tela de permissão OAuth e, se aplicável, ao manifesto do Apps Script.

Se você incluir mais de uma integração de app, adicione os escopos de cada um deles à página "Configuração de apps do SDK do Google Workspace Marketplace" e à tela de permissão OAuth.

Sempre use os escopos mais restritos possíveis. Por exemplo, não inclua um escopo completo do Drive se você precisar apenas de um escopo somente leitura.

Para projetos do Apps Script, consulte Escopos e veja mais detalhes.

Informações do desenvolvedor

Esses campos aparecem na página Detalhes do app.

Campos
Status do comerciante

Devido às leis de proteção ao consumidor, consumidores no Espaço Econômico Europeu (EEE) precisam ser informados se um comerciante no Google Workspace Marketplace é um comerciante ou não comerciante:

  • Comerciante: um comerciante é uma pessoa que atua para fins relacionados a um comércio, negócio, ofício ou profissão, ou em nome de um comerciante.
  • Não comerciante: um não comerciante (consumidor) é uma pessoa que atua para fins não profissionais.

Se não for especificado, o "Status do comerciante não especificado" aparecerá na página Detalhes do app do seu app.

Endereço de e-mail do desenvolvedor

Obrigatório para comerciantes. Não coletado para não comerciantes.

A localização da sua empresa. Insira um endereço de correspondência válido.

Nome do desenvolvedor O nome a ser exibido como o autor do app. Se você for um comerciante, forneça seu nome comercial ou razão social.
URL do site do desenvolvedor O site que descreve você (ou sua organização) como o desenvolvedor.
E-mail do desenvolvedor

O endereço de e-mail a ser usado como ponto de contato. Ele não está incluído nos detalhes do app. Verifique se este endereço de e-mail está atualizado. Ele é usado:

  • Se o Google precisar entrar em contato com o desenvolvedor, por exemplo, durante o processo de revisão do app.
  • Para enviar feedback sobre os complementos do Editor se um URL para informar problemas não for fornecido na página "Detalhes do app".
URL do site do aplicativo Opcional. O site que descreve melhor seu app.