Skip to main content

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.
Gurubase Google Drive integration page

Steps to Integrate

Create Google Drive Service Account

  1. Navigate to Google Cloud Console Service Accounts
  2. Select or Create a Project
    • Choose an existing project or create a new one
Google Cloud Console Service Accounts page
  1. 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 Service Account dialog
  1. 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”
Service Account Keys tab
Create new key dialog
  • The JSON key file will be automatically downloaded. Securely store this file as you’ll need it in the next step.
  1. Enable Google Drive API
    • Navigate to “APIs & Services” page (you can search for it in the console search bar)
APIs & Services page
  • Click “Enable APIs and services”
Enable APIs and services button
  • Search for “Google Drive API”
Search for Google Drive API
  • Click on “Google Drive API” and then click “Enable”
Enable Google Drive API

Connect Google Drive in Gurubase

  1. 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
  2. Import Service Account JSON
    • You’ll see the Google Drive integration page
Empty Google Drive integration state
  • Paste or upload the JSON key file you downloaded in Step 1
  • Click “Connect”
  1. Integration Setup Complete
    • After clicking “Connect”, the integration will be set up successfully
    • You’ll see the integration is now connected
No files shared message

Share Files with Service Account

  1. 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”
Share files with service account in Google Drive
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

  1. Return to Gurubase
    • Go back to the Gurubase integration page
    • Click “Sync Now” to start indexing the shared files
  2. Monitor Sync Status
    • Once files are shared and synced, you’ll see them listed
Shared and synced files
  • You can see the sync status and when files were last indexed
Last indexed timestamp

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 .xlsx format
  • Google Docs: Automatically converted to .pdf format
Only the file types listed above will be indexed. Other file types will be skipped during the sync process.

Next Steps