Guidelines for Google Drive Prerequisites
Before creating a Google Drive Collection in SearchBlox, you must create a Service Account in Google Cloud Console and share the required Google Drive files and folders with it. This guide covers the complete setup process.
Note: To create a Service Account, your Google account must have the Create Service Accounts (
roles/iam.serviceAccountCreator) IAM role on the project.
Step 1 — Create a Service Account
-
Sign in to Google Cloud Console at https://console.cloud.google.com/iam-admin
-
Go to Service Accounts: https://console.cloud.google.com/iam-admin/serviceaccounts
-
Select an existing project or create a new one at https://console.cloud.google.com/projectcreate
-
Click Create Service Account at https://console.cloud.google.com/iam-admin/serviceaccounts/create, fill in the required details, and click Done
-
After the Service Account is created, note the following information from the Service Account Details page:
- Application Name – The name provided during Service Account creation.
- Service Account ID (Email) – The email address associated with the Service Account. This is also the default Service Account user.
Note: The Service Account ID email is the default user used to access Google Drive files. To use a different email address, the Folder Admin (
roles/resourcemanager.folderAdmin) role is required on the project. Without this role, the user will not have access to the shared files and folders.
Step 2 — Create a Key File
- Open the Service Account page.
- Navigate to the Keys tab.
- Click Add Key and select Create New Key.
- Choose either JSON or P12 format.
- Click Create. The key file will be downloaded automatically.
- Store the key file securely. It will be required when configuring the Google Drive Collection in SearchBlox.
Note: The JSON format is recommended because it is easier to manage than the P12 format.
Step 3 — Grant Permissions and Share Files
- Navigate to IAM & Admin in Google Cloud Console.
- Assign the Service Account the appropriate roles required to access your Google Drive content.
- In Google Drive, share the files and folders you want SearchBlox to index with the Service Account email address.
- Grant at least Viewer permission to the Service Account so it can read the content.
Important: SearchBlox can only index files and folders that have been explicitly shared with the Service Account. Verify that all required content has been shared before running the initial index.
