Skip to main content

Google Workspace Integration

Integrate Google Workspace with TheStorage to automatically synchronize your organization's user directory. This enables employee data to be fetched and kept up-to-date without manual configuration.

Requirements​

  • Google Workspace Admin permissions are required.

Step 1: Create a Google Cloud Project​

  1. Navigate to console.cloud.google.com.

  2. Click New Project.

    New project

  3. Name the project TheStorage and select an appropriate location.

    Project name

  4. Click Create and wait for the project to be provisioned.

Step 2: Create a Service Account​

  1. Go to APIs & Services > Credentials.

    Credentials

  2. Click Create Credentials > Service Account.

    Service Account

  3. Fill in the Service Account details:

    FieldValue
    Service Account Namethestorage_svc
    Service Account IDthestorage_svc (auto-generated)
    Description (optional)TheStorage Service Account

    Create service account

  4. Click Create and Continue. Skip the optional access steps and click Done.

Step 3: Generate a Key​

  1. Click the edit icon for the service account.

    Edit

  2. Copy the Unique ID — you will need it later.

    Unique ID

  3. Go to the Keys tab and click Add Key > Create new key.

    Keys

  4. Select JSON as the key type and click Create.

    Key type

  5. A JSON file will be downloaded. Keep this file in a secure location — it will be needed during the TheStorage configuration.

Step 4: Configure Domain-Wide Delegation​

  1. Navigate to https://admin.google.com and log in with your administrator account.

  2. Go to Security > Access and Data Control > API Controls.

    API Controls

  3. Click Manage Domain Wide Delegation.

    Domain-wide delegation

  4. Click Add new and configure:

    FieldValue
    Client IDThe Unique ID you copied earlier
    OAuth scopeshttps://www.googleapis.com/auth/admin.directory.user.readonly

    New client ID

  5. Click Authorize.

Step 5: Complete TheStorage Configuration​

Fill out the Google Workspace integration form on TheStorage with:

  • The JSON key file downloaded during Step 3.
  • Your company domain name (e.g., mycompanyname.com).
  • The administrator email address executing this integration.