Article
List app integrations together | Google Workspace Marketplace
developers.google.com
Quoted on this wiki
Every place a page here uses this source, in the order the words come in it.
List app integrations together “Publishing multiple app integrations within a single app listing streamlines user experience by enabling simultaneous installation and authorization.” This approach can accelerate user acquisition compared to separate listings for each integration.
Before you include more than one app integration in your app listing, consider the following effects: “The consent screen lists all scopes required by all app integrations.” Any new scope is verified (when applicable).
This approach can accelerate user acquisition compared to separate listings for each integration. “Web apps, Drive apps, and Editor add-ons (Docs, Sheets, Slides, Forms) can often be combined within one listing, with certain compatibility rules outlined in a provided table.” Before combining integrations, developers should be aware of potential impacts like broader consent screens, scope verification, and user access considerations.
To determine if you can list your app integrations together, refer to the next section. “Use this comparison table to learn which app integrations can be included in a single app listing.” To use this table, find your starting point in the left-hand column and then look across the top row for your endpoint. Trace both lines until they intersect.
Use this comparison table to learn which app integrations can be included in a single app listing. “To use this table, find your starting point in the left-hand column and then look across the top row for your endpoint. Trace both lines until they intersect.” Can be included with: Web app Drive app Docs add-on Sheets add-on Slides add-on Forms add-on Google Workspace add-on Google Chat app Web app Drive app Docs add-on Sheets add-on Slides add-on Forms add-on Google Workspace add-on * ** Google Chat app** **
Can be included with: Web app Drive app Docs add-on Sheets add-on Slides add-on Forms add-on Google Workspace add-on Google Chat app Web app Drive app Docs add-on Sheets add-on Slides add-on Forms add-on Google Workspace add-on * ** Google Chat app** ** “* You can't list more than one Google Workspace add-on in your app listing,” ** Only available for Google Chat apps built as Google Workspace add-ons. Otherwise, Chat apps must be listed separately in the Google Workspace Marketplace.
Can be included with: Web app Drive app Docs add-on Sheets add-on Slides add-on Forms add-on Google Workspace add-on Google Chat app Web app Drive app Docs add-on Sheets add-on Slides add-on Forms add-on Google Workspace add-on * ** Google Chat app** ** “but you can build a single Google Workspace add-on that extends Gmail, Google Calendar, Google Chat, Google Drive, Google Docs, Google Sheets, Google Slides, and Google Meet.” ** Only available for Google Chat apps built as Google Workspace add-ons. Otherwise, Chat apps must be listed separately in the Google Workspace Marketplace.
* You can't list more than one Google Workspace add-on in your app listing, but you can build a single Google Workspace add-on that extends Gmail, Google Calendar, Google Chat, Google Drive, Google Docs, Google Sheets, Google Slides, and Google Meet. “** Only available for Google Chat apps built as Google Workspace add-ons. Otherwise, Chat apps must be listed separately in the Google Workspace Marketplace.” Before you add multiple app integrations
Web apps, Drive apps, and Editor add-ons (Docs, Sheets, Slides, Forms) can often be combined within one listing, with certain compatibility rules outlined in a provided table. “Before combining integrations, developers should be aware of potential impacts like broader consent screens, scope verification, and user access considerations.” Detailed instructions are given for adding multiple integrations to both new and existing app listings, emphasizing the use of a shared Google Cloud project.
Any new scope is verified (when applicable). “If you add a new app integration that requires additional scopes to an existing app listing, administrators who have already installed the original app for their domain need to authorize the additional scopes in the Google Admin console. Until they do, users within the domain are individually prompted to authorize.” If you plan to combine existing app listings, there are additional effects to consider. If you move an app integration from its original app listing to another app listing:
If you plan to combine existing app listings, there are additional effects to consider. If you move an app integration from its original app listing to another app listing: “Existing users might lose access and need to install the app listing you moved it to.” User counts and reviews don't carry over.
Existing users might lose access and need to install the app listing you moved it to. “User counts and reviews don't carry over.” You might need to update the consolidated Google Cloud project's configuration to accommodate the new app integration.
Detailed instructions are given for adding multiple integrations to both new and existing app listings, emphasizing the use of a shared Google Cloud project. “If you've developed multiple app integrations, you might want to publish them together in one app listing.” For example, if your app offers a specific integration with Google Sheets and is available as a web app, instead of creating two app listings for a Sheets add-on and a web app, you can list them together as one app.
Before combining integrations, developers should be aware of potential impacts like broader consent screens, scope verification, and user access considerations. “Detailed instructions are given for adding multiple integrations to both new and existing app listings, emphasizing the use of a shared Google Cloud project.” If you've developed multiple app integrations, you might want to publish them together in one app listing. Doing so lets users install and authorize them at the same time, provides a more seamless user experience, and lets you grow your user count faster because all integrations are installed from one listing.
If you haven't created a Google Cloud project yet, set up a Google Cloud project. If you built your app integrations in Google Apps Script, make sure they're all associated with the same Google Cloud project. “Enable and configure the Google Workspace Marketplace SDK with the information for all the app integrations. Explain in the description that the app includes multiple app integrations.” Add app integrations to an existing app listing
If the app integration you want to add was built with Apps Script, set your add-on's Apps Script project to the existing app's Google Cloud project. “Add information about the new app integration to the App Configuration and Store Listing pages.” Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.