Skip to main content
Google Workspace integration
Connect Google Workspace to let Adapt access Google Drive, Docs, Sheets, and Slides on behalf of your organization using a service account with domain-wide delegation.

​
Prerequisites

Before setting up, you’ll need:
  • Google Workspace admin access to configure domain-wide delegation
  • Google Cloud Console access to create a service account
  • A user email that the service account will impersonate

​
Setup

​
Step 1: Create a Google Cloud Project

1

Open Google Cloud Console

Go to console.cloud.google.com and sign in with your Google Workspace admin account.
2

Create a new project

Click the project dropdown at the top, then New Project. Name it something like “Adapt Integration”.
Create a new Google Cloud project
3

Select the project

Make sure your new project is selected in the project dropdown before continuing.

​
Step 2: Enable Required APIs

1

Navigate to APIs & Services

In the left sidebar, go to APIs & Services > Library.
Google Cloud API Library
2

Enable the following APIs

Search for and enable each of these APIs:
APIPurpose
Google Drive APIAccess files and folders
Google Docs APIRead and write documents
Google Sheets APIRead and write spreadsheets
Google Slides APIRead and write presentations
Enable an API in Google Cloud

​
Step 3: Create a Service Account

1

Go to Service Accounts

Navigate to IAM & Admin > Service Accounts in the left sidebar.
Service Accounts page
2

Create service account

Click Create Service Account at the top.
  • Name: adapt-integration
  • Description: “Service account for Adapt integration with Google Workspace”
Create service account form
3

Skip optional steps

You can skip the “Grant this service account access” and “Grant users access” steps. Click Done.
4

Create a key

Click on your new service account, go to the Keys tab, and click Add Key > Create new key.
  • Select JSON format
  • Click Create
Create service account key
Save this JSON file securely. You’ll need it to connect Adapt, and it cannot be downloaded again.

​
Step 4: Configure Domain-Wide Delegation

1

Enable delegation on the service account

In the service account details, click Advanced Settings, and note the Client ID of the service account.
Enable domain-wide delegation
2

Open Google Workspace Admin Console

Go to admin.google.com and navigate to Security > Access and data control > API controls.
3

Manage Domain-wide Delegation

Click Manage Domain Wide Delegation, then Add new.
4

Add the Client ID and scopes

Enter the Client ID for the service account, then add these OAuth scopes (comma-separated):For read & write access:
https://www.googleapis.com/auth/drive,https://www.googleapis.com/auth/spreadsheets,https://www.googleapis.com/auth/documents,https://www.googleapis.com/auth/presentations
For read-only access:
https://www.googleapis.com/auth/drive.readonly,https://www.googleapis.com/auth/spreadsheets.readonly,https://www.googleapis.com/auth/documents.readonly,https://www.googleapis.com/auth/presentation.readonly
Add OAuth scopes
5

Authorize

Click Authorize to complete domain-wide delegation setup.

​
Step 5: Connect to Adapt

1

Go to Integrations

In Adapt, navigate to Settings > Integrations > Google Workspace.
2

Add Google Workspace

Click Add Google Workspace to open the connection dialog.
3

Enter credentials

  • Service Account JSON: Paste the entire contents of the JSON key file for your service account.
  • Fixed User Email: Enter the email of a user in your domain that Adapt should impersonate (e.g., adapt@yourdomain.com)
Connect Google Workspace dialog
4

Connect

Click Connect to complete the setup.

​
Permissions

Depending on your configuration, Adapt will have access to:
PermissionRead-OnlyRead & Write
Drive - Read files✓✓
Drive - Create/edit files✓
All access is performed by impersonating the Fixed User Email you specified during setup. Adapt will have the same access as that user within the authorized scopes.

​
Capabilities

With Google Workspace connected, Adapt can help you work with your organization’s documents and communications.

​
Examples

Read and analyze documents: 
Summarize the product roadmap doc in our Drive
Create content: 
Draft a project proposal doc based on our discussion and create a Google doc for it.

​
Troubleshooting

​
”Unauthorized” or “Access denied” errors

  • Check that the OAuth scopes in Admin Console match what Adapt needs
  • Ensure the Fixed User Email is a valid user in your domain

​
”API not enabled” errors

  • Return to the Google Cloud Console and verify all required APIs are enabled
  • Make sure you’re in the correct project

​
Changes not appearing

  • Domain-wide delegation can take a few minutes to propagate
  • Try disconnecting and reconnecting the integration

​
Security Considerations

  • The service account JSON contains sensitive credentials. Never share it publicly.
  • Use the read-only scopes if Adapt doesn’t need to create or modify content.
  • Consider creating a dedicated admin user for the Fixed User Email to audit Adapt’s activity.
  • You can revoke access at any time by deleting the domain-wide delegation entry in Admin Console.