Introduction
Integrate Gurubase with Google Drive to use your Google Drive files as data sources for Gurubase. Files shared with the service account will be automatically indexed and kept in sync.Files indexed through Google Drive integration are automatically labeled with
google_drive. This label cannot be manually deleted.
Steps to Integrate
Create Google Drive Service Account
-
Navigate to Google Cloud Console Service Accounts
- Go to Google Cloud Console
- Navigate to “IAM & Admin” > “Service Accounts”
-
Select or Create a Project
- Choose an existing project or create a new one

- Create a Service Account
- Click “Create Service Account”
- Enter a name for your service account
- Click “Create and Continue”
- Optionally add a description
- Skip “2. Permissions” and “3. Principals with access”
- Click “Done”

- Create and Download JSON Key
- Click on the service account you just created
- Navigate to the “Keys” tab
- Click “Add Key” > “Create new key”
- Select “JSON” as the key type
- Click “Create”


- The JSON key file will be automatically downloaded. Securely store this file as you’ll need it in the next step.
- Enable Google Drive API
- Navigate to “APIs & Services” page (you can search for it in the console search bar)

- Click “Enable APIs and services”

- Search for “Google Drive API”

- Click on “Google Drive API” and then click “Enable”

Connect Google Drive in Gurubase
-
Navigate to Integrations
- Go to the Gurubase dashboard
- Click on “My Gurus” under the profile
- Click on the Guru you want to integrate with Google Drive
- Click on the “Integrations” tab
- Click on the “Google Drive” option
-
Import Service Account JSON
- You’ll see the Google Drive integration page

- Paste or upload the JSON key file you downloaded in Step 1
- Click “Connect”
- Integration Setup Complete
- After clicking “Connect”, the integration will be set up successfully
- You’ll see the integration is now connected

Share Files with Service Account
- Share Files in Google Drive
- Go to your Google Drive
- Select the files or folders you want to index
- Right-click and select “Share” or click the “Share” button
- In the sharing dialog, enter the service account email address (written on the integration page, or found in the JSON key file under
client_email) - Set the permission to “Viewer” (read-only access)
- Click “Send”

Only files shared with the service account email address will be indexed. Make sure to share all files and folders you want to include in your Guru.
Sync Files
-
Return to Gurubase
- Go back to the Gurubase integration page
- Click “Sync Now” to start indexing the shared files
-
Monitor Sync Status
- Once files are shared and synced, you’ll see them listed

- You can see the sync status and when files were last indexed

Supported File Types
The Google Drive integration currently processes the following file types:- Text Files:
.txt,.md - Spreadsheets:
.xls,.xlsx - PDFs:
.pdf - Google Sheets: Automatically converted to
.xlsxformat - Google Docs: Automatically converted to
.pdfformat
Only the file types listed above will be indexed. Other file types will be skipped during the sync process.