Creating a Service Account for Google Drive

To use a Service Account for Google Drive indexing, follow these steps:

Enable the Google Drive API in your Google Cloud Console

Once the API is enabled, you'll see a green checkmark labeled "API Enabled"

Create a Service Account

1. Navigate to the Service Accounts dashboard under IAM & Admin / Service Accounts
2. Click the "+ Create service account" button

3. Give the Service Account a name, like "Google Drive for Convictional"
   1. Click "Create and continue"
   2. Click the blue "Done" button at the bottom of the form. You don't need to grant optional access permissions.

Create a JSON Access Key for your Service Account

1. Click the "Keys" menu under your newly-created Service Account

2. Click the "Add key" button and select "Create new key"

3. Select "JSON" as they Key Type and click "Create"

4. Your private key will be downloaded to your computer with a .json file extension
5. Click the "Details" menu of your service account

6. Take note of the email address for the Service Account. It should look something like google-drive-for-convictional@mygcpproject-12345.iam.gserviceaccount.com

Invite your Service Account to your Google Drive

Your Service Account will need to be granted access to the files/folders/shared-drives you'd like to index in Convictional. You can do this by adding your Service Account as a "Viewer" on those resources.

To grant access to a Shared Drive, click the "Manage members" or "Share" button and add your Service Account by its email address.

Add your Service Account key to Convictional

1. Navigate to your Organization Settings page in Convictional.
2. Scroll down to the Google Drive section

3. Enter your Service Account's email address as the "User to impersonate"
4. Open your Service Account's JSON key in a text editor, select all the contents, and copy them to your clipboard. Then paste that content into the "Service account key" field.
5. Click "Save" and presto! You did it!

Indexing Schedule

Content for Google Drive Service Accounts is indexed at the 30-minute mark of every hour (i.e. 1:30, 2:30, 3:30, etc.).