This page contains the setup guide and reference information for the Google Sheets connector.
Prerequisites
Before connecting your Google Sheets account, ensure that:
-
You have an active Google account with access to Google Sheets.
-
You have access to the Google Cloud Console.
Setup Guide
Follow these steps to connect your Google Sheets account:
-
Visit Google Cloud Console: Go to console.cloud.google.com.
-
Create a Project: Click “Create Project”, set a name (e.g., Keragon Google Sheets Project), and click Create.
-
Select the Project: After creation, click Select Project.
-
Enable APIs: Use the menu to go to “Enabled APIs & services” → Click the Search field → Search and select Google Sheets API → Click Enable. Repeat for Google Drive API.
-
Configure OAuth Consent Screen:
-
Go to OAuth consent screen from the menu.
-
Choose Internal as the user type, click Create.
-
Fill in App name (e.g., Keragon Google Sheets App), User support email, Developer contact email.
-
Click Save and continue.
-
Click Add or remove scopes, then manually add:
-
https://www.googleapis.com/auth/spreadsheets -
https://www.googleapis.com/auth/drive
-
-
Click Add to table, confirm both scopes are checked, then click Update.
-
Click Save and continue → Back to dashboard.
-
-
Create OAuth Credentials:
-
Go to Credentials → Click Create credentials → Choose OAuth client ID.
-
Set Application type to Web application.
-
Under “Authorized redirect URIs”, add:
-
https://api.us-east-1.keragon.com/rest/auth/callback -
https://api.us-1.keragon.com/rest/auth/callback
-
-
Click Create.
-
-
Get Your Credentials:
-
Copy the Client ID and Client Secret.
-
Go to the Keragon dashboard, navigate to the Google Sheets connector setup, and paste in the credentials.
-
Need more help connecting?
Check the fully extended Google Sheets connector setup guide for screenshots, detailed steps, and additional context.
You are now ready to authenticate and use Google Sheets in your HIPAA-compliant workflows on Keragon.
Troubleshooting and Common Errors
| Error Message | Description | Suggested Fix |
|---|---|---|
invalid_client |
The client ID or secret is incorrect. | Double-check your OAuth credentials and ensure they are correctly pasted in the Keragon dashboard. |
redirect_uri_mismatch |
Redirect URI used doesn't match the one set in Google Cloud. | Ensure both redirect URIs are added exactly as provided in the setup guide. |
insufficient permissions |
The required API scopes are missing. | Make sure the correct scopes (spreadsheets, drive) are added in the OAuth consent screen. |
403 Forbidden |
API is not enabled or user lacks access. | Verify both Sheets and Drive APIs are enabled and the user has permission. |
Limitations and Notes
-
The connector supports Google Sheets files that the authenticated user owns or has access to.
-
API quota limits from Google may apply and affect the number of operations you can perform daily.
-
Only OAuth 2.0 is supported for authentication.
-
Certain advanced features like conditional formatting or charts are not accessible through this connector.
-
Ensure that spreadsheets are not too large; reading or writing large datasets may result in timeouts.