Skip to content

Google Drive configuration

Google Drive can be shared with Supersimple either by:

  1. Sharing Google Drive or a folder with google-drive-reader@supersimple-production.iam.gserviceaccount.com
  2. Configuring your own Service Account and sharing its credentials with Supersimple.

Sharing Google Drive with Supersimple

The easiest option is to share your Google Drive or specific folders directly with Supersimple's service account.

  1. Open Google Drive in your browser
  2. Navigate to the shared drive or folder you want to share with Supersimple
  3. Right-click on the shared drive or folder and select Share
  4. In the Manage members dialog, click Add people and groups
  5. Enter the email address: google-drive-reader@supersimple-production.iam.gserviceaccount.com
  6. Set the permission level to Viewer (read-only access)
  7. Click Done to grant access
Google Drive sharing dialog

IMPORTANT

Provide Supersimple the following:

  • The URL of Shared Google Drive or folder.

Once shared, Supersimple will be able to access the shared drive or folder content.

Setting up Google Cloud Service Account Optional

To integrate with Google Drive with your own service account, create it in the Google Cloud Console and download its credentials JSON file.

Step 1: Create Service Account

Perform the following sections in Google Cloud Console:

  1. Go to IAM & Admin > Service Accounts
  2. Click Create Service Account
  3. Enter the following details:
    • Service account name: supersimple-admin
    • Service account ID: This will auto-populate as supersimple-admin
    • Description: Service account for Supersimple Google Drive integration
  4. Click Done
Create service account

Step 2: Create and Download JSON Key

  1. In the Service Accounts list, click on the supersimple-admin service account
  2. Go to the Keys tab
  3. Click Add Key > Create new key
  4. Select JSON as the key type
  5. Click Create and share the file downloaded to your computer with Supersimple.

Step 3: Share the drive with service account

Use the instructions above to share Google Drive with a service account. Another option is to add service account to a group that has access to shared Google Drive.

Step 4: Enable Admin SDK API

  1. Navigate to Admin SDK API page in Google Cloud Console. You'll find it at APIs & Services > Admin SDK API
  2. If the API is not enabled, click Enable API

IMPORTANT

Provide Supersimple the following:

  • JSON credentials file for supersimple-admin service account.
  • The URL of Shared Google Drive.

Setting up Google Workspace Groups Access Optional

If your Google Drive permissions are set up using Google Workspace groups, Supersimple needs access to read group membership. You can grant this access by assigning service account to the Groups Reader role in Google Workspace Admin.

Note: Only Google Workspace super administrators can assign admin roles.

Step 1: Assign Groups Reader Role

  1. Navigate to Account > Admin roles in Google Admin Console
  2. Find and click on Groups Reader role
  3. Click Assign service accounts
  4. Enter the service account email used to share Google Drive (either google-drive-reader@supersimple-production.iam.gserviceaccount.com or supersimple-admin@... created in the previous section)
  5. Click Add then Assign Role

This grants the service account read-only access to Google Workspace groups.

IMPORTANT

Provide Supersimple the following:

  • Google Workspace primary domain name.
  • JSON credentials file for supersimple-admin service account.
  • The URL of Shared Google Drive.