Listar integrações de apps

Se você desenvolveu várias integrações de apps, talvez queira publicá-las juntas em uma página de detalhes do app. Isso permite que os usuários instalem e autorizem ao mesmo tempo, oferece uma experiência do usuário mais integrada e permite aumentar a contagem de usuários mais rapidamente, porque todas as integrações são instaladas em uma única página de detalhes.

Por exemplo, se o app oferece uma integração específica com o Google Planilhas e está disponível como um app da Web, em vez de criar duas páginas de detalhes para um complemento do Planilhas e um app da Web, você pode listá-los juntos como um só app.

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

Integrações de apps que podem ser listadas juntas

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

Para usar esta tabela, encontre seu ponto de partida na coluna à esquerda e procure seu endpoint na linha de cima. Trace as duas linhas até que elas se cruzem.

Pode ser incluído com: App da Web App do Drive Complemento dos Documentos Complemento das Planilhas Complemento do Google Slides Complemento dos Formulários Complemento do Google Workspace App Google Chat
Web app
App Drive
Complemento do Google Documentos
Complemento das Planilhas
Complemento do Apresentações
Complemento Formulários
Complemento do Google Workspace * **
App Google Chat** **
* 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 funcione no Gmail, Google Agenda, Google Chat, Google Drive, Google Docs, Google Planilhas, Google Apresentações e Google Meet.

** Disponível apenas para apps do Google Chat criados como complementos do Google Workspace. Os apps de chat que não são complementos do Google Workspace precisam ser listados separadamente no Google Workspace Marketplace.

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

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

  • A tela de permissão lista todos os escopos exigidos por todas as integrações de apps.
  • Qualquer novo escopo é verificado (quando aplicável).
  • Se você adicionar uma nova integração de app que exija escopos adicionais a uma página de detalhes do app, os administradores que já tiverem instalado o app original no domínio precisarão 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 individual para autorizar.

Se você planeja combinar páginas de detalhes de apps, há outros efeitos a serem considerados. Se você mover uma integração de app da página original para outra:

  • Os usuários atuais podem perder o acesso e precisar instalar a página de detalhes do app para onde você moveu o app.
  • As contagens e avaliações de usuários não são transferidas.
  • Talvez seja necessário atualizar a configuração do projeto consolidado do Google Cloud para acomodar a nova integração de app.
  • É necessário verificar novamente os escopos do OAuth 2.0 porque eles foram aprovados para um projeto específico do Google Cloud.

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

Para adicionar várias integrações de apps 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. Se você criou as integrações de apps no Google Apps Script, verifique se elas 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 de apps.

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

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

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

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

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

    1. Na página "Configuração do app", em Extensão do app, selecione a integração de app que você quer adicionar e preencha os campos relevantes.
    2. Adicione informações sobre a nova integração de app às páginas "Configuração do app" e "Detalhes do app". Explique na descrição do app que ele inclui várias integrações. Para mais informações, consulte Atualizar ou cancelar a publicação de uma página de detalhes do app.