Skip to main content
All Collections
Setup the OS/ Google Drive and Groups Integration
Setup the OS/ Google Drive and Groups Integration

How you setup the OS/ Google Integration to create and maintain Google Shared Drives and Google Groups.

Updated over a week ago

Create Google Account Credentials for OS/

To use the OS/ Google Integration you have to use a Google Workspace Administrator to setup the following:

  1. Enable the Admin "SDK API" and "Google Drive API"

  2. Create Google Credentials as JSON

  3. Get your unique ID for your Google Workspace account

First you need to enable both APIs for OS/. To do so, log in to Google Cloud Platform with your Google Workspace Administrator Account via the following URL:

We recommend to create a dedicated project for OS/ by clicking "New Project" in the Resources Dialog.

Project name: You can use any "Project name", we recommend "goOS".

Organization and Location: Your Google Cloud Organisation.

Select your new project.

and doublecheck it's shown in the project dropdown and at "You're working in".

Enable the Google Drive and Groups APIs

Next we have to enable the

  1. Admin SDK API

  2. Google Drive API

Google APIs. The Admin SDK API is needed to integrate with Google Groups, the Google Drive API to create and maintain Google Shared Drives for your Projects.

To enable this two APIs, go to the Burger Menu in the upper left and navigate to "APIs & Services / Enabled APIs & services"

Click "Enable APIs and services"

Search for the "Admin SDK API" and enable it.

Go back to the Welcome Page and search for the "Google Drive API" and enable it.

Check if both, the "Admin SDK API" and "Google Drive API" are setup.

Create a Google Service Account

Select "Credentials" from the side menu.

Followed by "Manage service accounts" in the lower right of the following screen.

Klick "Create Service Account".

Enter "OS/" as Service Account Name.

And click "Done" directly.

Create a private Key for OS/

Open the newly created service account by clicking its Email.

Move to the "Keys" tab on the following screen.

Add a new key with the "Add Key" Dropdown.

Choose "Create new key".

Choose "json" as the key type.

And download the key. Depending on your browser, the download may ask for security permissions.

Store this json key file (e.g. goos-123456-456789c5c8bd.json), you will need it in the final step.

Delegate access privilegs for the access key.

Go back to "Details". Copy the "Client ID" into you clipboard and open the "Google Workspace Admin Console".

Go to "Security/ Access and Data Control/ API controls".

And open "Manage Domain wide delegation".

Next to "API Clients" click "Add New".

And paste the "Client ID" from the previous step into the "Client ID" Field.

In the OAuth scope copy/paste the following:

https://www.googleapis.com/auth/admin.directory.domain.readonly,https://www.googleapis.com/auth/admin.directory.user.readonly,https://www.googleapis.com/auth/drive,https://www.googleapis.com/auth/admin.directory.group

After you have added the scopes to the delegation, you'll find the os API Client in the list.

As second last step, goto "Account/ Account Settings" and

And copy your "Customer ID".

Enable the OS/ Google Drive and Google Groups Integration

Activate the OS/ Google Drive Integration in the Integration Settings.

Paste the content of the json key file to the "Google account data with credentials in JSON format" field.

Set the "Email of the administrator" to your Administrator Login. This user will own all Google Drive shares.

Paste your "Customer ID" to the "The unique ID for the customer's Google Workspace account" field.

And save the integration.

Once saved, edit the active integration.

And configure your default Google Workspace Domain.

Did this answer your question?