Listar integrações de apps

Se você desenvolveu várias integrações de apps, talvez queira publicá-las juntas em uma única página de detalhes. Isso permite que os usuários instalem e autorizem as integrações ao mesmo tempo, proporcionando uma experiência mais integrada e aumentando o número de usuários mais rapidamente, já que todas as integrações são instaladas em uma única página.

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 páginas de detalhes para um complemento do Planilhas e um app da Web, você pode listá-los juntos como um único 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.

Para usar essa tabela, encontre seu ponto de partida na coluna da esquerda e procure o endpoint na linha superior. Siga 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
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** **
* 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 se estenda ao Gmail, Google Agenda, Google Chat, Google Drive, Google Docs, Planilhas Google, Apresentações Google e Google Meet.

** Disponível apenas para apps do Google Chat criados como complementos do Google Workspace. Caso contrário, os apps do Chat 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 mais escopos a uma página de detalhes de app, os administradores que já instalaram o app original no domínio precisarão autorizar os escopos adicionais no Google Admin Console. Até que isso aconteça, os usuários do domínio vão receber solicitações individuais de autorização.

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 de detalhes original para outra:

  • Os usuários atuais podem perder o acesso e precisar instalar a página de detalhes do app para a qual você moveu a integração.
  • As contagens de usuários e as avaliações 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 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 de apps a uma nova página de detalhes, faça o seguinte:

  1. Se você ainda não criou um projeto na nuvem do Google Cloud, configure um projeto na nuvem do Google Cloud. 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.

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

Para adicionar várias integrações de apps a uma página de detalhes existente, 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 complemento do Apps Script para o projeto na nuvem do Google Cloud do app.

  3. No projeto na nuvem do Google Cloud do app, 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 a ser adicionada e preencha os campos relevantes.
    2. Adicione informações sobre a nova integração de app às páginas "Configuração do app" e "Página de 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.