Frequently Asked Questions

This section contains answers to some common questions about G Suite Marketplace.

Why must I add scopes to different places?

The scopes you add to each place are used in different ways.

  • The scopes added to the OAuth consent screen are used for OAuth verification.
  • The scopes added to the G Suite Marketplace SDK are used for domain-wide and individual installs to authorize your app.
  • If your app was built in Apps Script, the scopes added to the manifest are necessary for your app to function properly.

For example, if you publish an app that includes a Sheets add-on and a Docs add-on, each add-on’s Apps Script manifest only includes the scopes specific to the add-on. In your GCP project, the OAuth consent screen and G Suite Marketplace SDK include the scopes for both add-ons.

Once I’ve published, how can users access my app listing?

If you’ve enabled individual installations, people can find and install your app directly from G Suite Marketplace. If your app is a Google Chat bot, people can find it in the chatbot catalog.

If you’ve enabled admin only installs, domain admins and users who aren’t logged in can find your app listing on G Suite Marketplace, but only admins can install your app. If your app is a Google Chat bot, domain admins can find it in the chatbot catalog.

Does an administrator have the ability to do an individual install?

Yes, even if individual installs aren’t enabled, admins can install an app for themselves to test it before they install the app for their entire domain.

How can I create additional owners of an app listing?

To give someone access to your app listing, add them to your Google Cloud Platform project. See Granting, changing, and revoking access to resources.

If you built your app with Apps Script, you can use a shared drive as the source location for your script project. This ensures that no single account is the sole owner of the project. Make sure your collaborators have access to the shared drive.

How can I get my app listing to show up on the homepage (for example, Most Popular, New Arrivals, Top Rated)?

App listings featured on the homepage are algorithmically selected based on a combination of rankings, reviews, install performance, and other factors.

How do app listings get added to the “Works with...” lists?

This is determined by the app integrations within your app. For example, a Sheets add-on appears under “Works with Sheets.”

For G Suite add-ons, the “Works with…” category is determined by the host apps specified in the add-on’s manifest. For example, if a G Suite add-on extends Gmail, the app listing appears in the G Suite Marketplace under "Works with Gmail" after publication.

Web apps aren’t included in the “Works with…” categories.

I also have an Android app in the Android Play Store. Can the reviews and ratings from my listings be merged?

No, the install numbers and user ratings from apps on the Android Play Store can’t be combined with G Suite Marketplace app listings.