Listar integrações de apps

Se você desenvolveu várias integrações de apps, convém publicá-las em uma única página "Detalhes do app". Isso permite que os usuários os instalem e autorizem ao mesmo tempo, proporciona uma experiência melhor e aumenta o número de usuários com mais rapidez, já que todas as integrações são instaladas em uma página de detalhes.

Por exemplo, se o seu aplicativo oferece uma integração específica com o Planilhas e está disponível como um aplicativo da Web, em vez de criar duas listas de aplicativos para um complemento do Planilhas e um aplicativo da Web, é possível listá-los juntos como um aplicativo.

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

Integrações de apps que você pode listar

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

Pode ser incluído com: App da Web Aplicativo do Google Drive Complemento do Documentos Complemento do Planilhas Complemento do Apresentações Complemento dos 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 Google x x x x x x
Complemento do Planilhas x x x x x x
Complemento do Apresentações x x x x x x
Complemento do 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 "Detalhes do app", mas é possível criar um único complemento que inclua o Gmail, o Agenda, o Drive, o Documentos, o Planilhas e o Apresentações.

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

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

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

  • A tela de consentimento lista todos os escopos exigidos por todas as integrações de apps.
  • Qualquer escopo novo é verificado (quando aplicável).
  • Se você adicionar uma nova integração de app que exija escopos adicionais a uma página "Detalhes do app" atual, os administradores que já instalaram o app original no domínio precisarão autorizar os escopos adicionais no Google Admin Console. Até que façam isso, os usuários no domínio são solicitados individualmente a autorizar.

Se você pretende combinar as páginas "Detalhes do app" atuais, há outros efeitos a serem considerados. Se você mover uma integração do app da página "Detalhes do app" original para outra página "Detalhes do app":

  • Os usuários podem perder o acesso e precisar instalar a página "Detalhes do app" para onde ele foi movido.
  • 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 aplicativos.
  • 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 a uma nova página "Detalhes do app"

  1. Se você ainda não criou um projeto do Google Cloud, configure um do Google Cloud. Se você criou suas integrações de apps no Apps Script, verifique se todas estão associadas ao mesmo projeto do Google Cloud.
  2. Ativar e configurar 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 "Detalhes do app"

  1. Verifique se você tem acesso para editar o projeto do Google Cloud do app.
  2. Se a integração do app que você quer adicionar foi criada com o Apps Script, mude o projeto do Apps Script do seu complemento para o projeto do Google Cloud do app existente.
  3. No projeto do Google Cloud do app, atualize o SDK do Google Workspace Marketplace.
    1. Na página "App Configuration", em App Extension, selecione a integração do app a ser adicionada e preencha os campos relevantes.
    2. Adicione informações sobre a nova integração do app às páginas "Configuração do app" e "Detalhes do app". Explique na descrição que ele inclui várias integrações.