Breadcrumbs

Google Drive (Business)

This guide explains what you, as the customer, need to provide to enable the integration between your Google Drive (Business) CMS and our platform.

1. Prerequisites

Before proceeding, ensure you have the following:

  • A Google Business Suite account.

  • A Service Account Email ID for impersonation.

  • Admin access to your Google Workspace

2. Grant Access to the Service Account

Google does not provide an API to approve admin consent, so the admin of your organization must manually grant the Google Drive API access to the Marketplace service account.

For Existing Customers Only - Remove Previous Domain-Wide Delegation (Optional)

If you previously configured domain-wide delegation settings for this integration, you should remove them as they are no longer required.

To remove previous configuration:

  1. Login to Google Admin Console

  2. Navigate to Security → Search for API controls

  3. Select Manage Domain-wide delegation

  4. Locate the marketplace service account Client ID and associated Scopes

  5. Remove the entry

image-20251209-102352.png


Note: New customers can skip this step entirely. This is only applicable if you have previously set up domain-wide delegation for our service account.

⚠️ Important: Use "My Drive", not "Shared Drive" (Team Drive)

The files and folders you want to integrate must live in a personal Google Drive ("My Drive") and be shared directly with the service account by email. Items inside a Shared Drive (Team Drive) are not supported — even if the service account is added as a member of the Shared Drive, the integration will not be able to read its contents.

How to tell which one you have: in the Google Drive web UI, files under "My Drive" in the left sidebar are personal; anything listed under "Shared drives" is a Team Drive and will not work with this integration.

If your content is currently in a Shared Drive: copy or move the file/folder into a team member's "My Drive", then share it directly with [email protected] as Viewer.

Grant Access to Specific Files and Folders (Recommended)

Instead of broad domain-wide access, you will now share specific files and folders directly with the service account.

Steps:

  1. Navigate to the Google Drive files and folders you want to integrate

  2. Share each file or folder with the Service Account Email ID: [email protected]

  3. Grant Viewer access permissions to the service account

Benefits of this approach:

  • The service account only has access to explicitly shared files and folders

  • No unrestricted access to your entire Google Drive

Next Steps

Once you have granted the necessary permissions, notify our delivery team to complete the integration setup.