How G Suite Marketplace apps use G Suite data

The third-party apps available in the G Suite Marketplace can integrate with your G Suite data in different ways.

The sections below describe each integration point, with links for more information about each one.

Gmail

Apps that integrate with mail have access to your Gmail data.

Two common methods of mail integration are with sidebar gadgets and contextual gadgets.

  • Sidebar gadgets are simple HTML and JavaScript web applications that can be embedded in a side pane of Gmail. These gadgets can extend Gmail with more functionality and content-rich data displays.
  • Contextual gadgets draw information from the web based on the contents of an email message. For example, contextual gadgets can display content previews based on links in a message.

Contextual gadgets use the following APIs:

  • Extractor APIs—Contextual gadgets use this API to detect contextual clues in email, determine which types of content trigger the gadget, and pass the triggering content to the gadget. Learn more
  • IMAP over OAuth API—Gmail supports the IMAP protocol for accessing and sending messages. This API lets the gadget have IMAP access to Gmail via OAuth. Learn more
  • GMAIL Atom Feeds API—Contextual gadgets use this API to feed updates from websites, blogs, and Gmail. Learn more

If you install an app that uses contextual gadgets, we recommend that you alert your users to the possibility that the gadgets can respond to the content of their email messages.

For more information about how apps integrate with Gmail, go to https://developers.google.com/gmail/.

Calendar

Apps that integrate with your calendar have access to your Google Calendar data, including invitations and events.

The Google Calendar API allows apps to edit calendars. For example, an app can create and delete calendar events or send invitations.

For more information about how apps integrate with Calendar, go to https://developers.google.com/google-apps/calendar/.

Drive

Apps that integrate with Google Drive are able to programmatically access and manipulate user data stored with Google Drive files, including Google Docs, Sheets, and Slides. For example:

  • Retrieve documents that match specific keywords, categories, or metadata
  • Modify the sharing permissions of documents and folders
  • Review, download, or publish a document’s revision history
  • Export documents
  • Create online backups of local documents, spreadsheets, presentations, and PDFs
  • Create folders, and move documents and folders in and out of folders

Integration is provided through the Google Drive SDK. 

For more information about how apps integrate with Drive, go to https://developers.google.com/drive/.

Contacts

Apps that integrate with Contacts use the Google Contacts API version 3.0 to access and edit contacts. 

For more information about how apps integrate with Contacts, go to https://developers.google.com/google-apps/contacts/v3/.

Google apps launcher

Apps that integrate with the Google apps launcher are listed in the launcher. 

Single sign-on

Apps that integrate with single sign-on allow users to securely sign in to the apps using their G Suite credentials. This can be done in a few ways:

  • OAuth2 is an open protocol that allows secure authorization in a simple and standard method. All new apps available through your Admin console will use Oauth2 for single sign-on. Learn more
  • OpenID Federated Login Service for G Suite allows users to securely sign in to third-party websites using their G Suite user account. Learn more
  • SAML single sign-on allows secure web domains to exchange user-authentication and user-authorization data. Using SAML, an online service provider can contact a separate online identity provider to authenticate users who are trying to access secure content. Learn more

Support for G Suite Marketplace apps integration

In general, there are two types of Independent Software Vendor (ISV)-created G Suite Marketplace apps that integrate with our services: supported and unsupported.

While we welcome all innovation and integration with our services, note that G Suite Marketplace apps that use these implementation types may not always work.

It's important that Google maintains the flexibility to dynamically change our products to provide the service, scale, availability, and innovation our customers expect. If we make substantive changes to a product, we also strive to make the capabilities available that best allow integration with our services.

Was this helpful?
How can we improve it?