Listar integrações de apps

Se você desenvolveu várias integrações de apps, publique-as juntas em uma listagem de apps. Isso permite que os usuários instalem e autorizem as integrações ao mesmo tempo, oferece uma experiência mais integrada e permite que você aumente a contagem de usuários mais rapidamente, porque todas as integrações são instaladas em uma listagem.

Por exemplo, se o app oferece uma integração específica com o Planilhas Google e está disponível como um app da Web, em vez de criar duas listagens de apps para um complemento do Planilhas e um app da Web, é possível listá-los juntos como um único app.

Para determinar se é possível listar as integrações de apps em conjunto, consulte a próxima seção.

Integrações de apps que podem ser listadas juntas

Use esta tabela para saber quais integrações de app podem ser incluídas em uma única página de apps.

Pode ser incluído com: App da Web Aplicativo do Google Drive Complemento do Documentos Complemento do app Planilhas Complemento do Apresentações Complemento do app Formulários Complemento do Google Workspace App Google Chat**
App da Web x x x x x
App Drive x x x x x x
Complemento do Documentos x x x x x x
Complemento de Planilhas x x x x x x
Complemento do Apresentações x x x x x x
Complemento de formulários x x x x x x
Complemento do Google Workspace x x x x x x*
App Google Chat**
*Complementos do Google Workspace: não é possível listar mais de um complemento do Google Workspace na página de detalhes do app, mas você pode criar um único complemento do Google Workspace que complementa o Gmail, o Agenda, o Drive, os Documentos, as Planilhas e as Apresentações.

**Os apps do Google Chat não podem ser incluídos com outras integrações de apps.

Antes de adicionar várias integrações de apps

Antes de incluir mais de uma integração de app na página "Detalhes do app", considere os seguintes efeitos:

  • A tela de consentimento lista todos os escopos necessários para todas as integrações de apps.
  • Qualquer novo escopo é verificado (quando aplicável).
  • Se você adicionar uma nova integração de app que exija outros escopos a uma lista de apps existente, os administradores que já instalaram o app original precisam autorizar os escopos adicionais no Google Admin Console. Até que isso aconteça, os usuários no domínio vão receber uma solicitação de autorização individual.

Se você planeja combinar as listagens de apps atuais, há outros efeitos a considerar. Se você mover uma integração de app da listagem original para outra:

  • Os usuários atuais podem perder o acesso e precisar instalar a lista de apps para a qual você mudou.
  • As contagens e avaliações de usuários não são transferidas.
  • Talvez seja necessário atualizar a configuração consolidada do projeto do Google Cloud para acomodar a nova integração de apps.
  • É necessário revalidar os escopos do OAuth 2.0 porque eles foram aprovados anteriormente para um projeto específico do Google Cloud.

Adicionar várias integrações de apps a uma nova página de detalhes

Para adicionar várias integrações a uma nova página de detalhes do app, faça o seguinte:

  1. Se você ainda não criou um projeto do Google Cloud, configure um projeto do Google Cloud. Se você criou as integrações do app no Apps Script, verifique se todas estão associadas ao mesmo projeto do Google Cloud.

  2. Ative e configure o SDK do Google Workspace Marketplace com as informações de todas as integrações de apps. Explique na descrição que o app inclui várias integrações.

Adicionar integrações a uma página de detalhes do app

Para adicionar várias integrações a uma página de detalhes do app, faça o seguinte:

  1. Verifique se você tem acesso de edição ao projeto do Google Cloud do app.

  2. Se a integração que você quer adicionar foi criada com o Apps Script, configure o projeto do Apps Script do complemento para o projeto do Google Cloud do app atual.

  3. No projeto do Google Cloud do app atual, atualize o SDK do Google Workspace Marketplace.

    1. Na página "App Configuration", em App Extension, selecione a integração do app para adicionar e preencher os campos relevantes.
    2. Adicione informações sobre a nova integração nas páginas "Configuração do app" e "Detalhes do app". Explique na descrição do app que ele inclui várias integrações.