Google Drive
Google Drive is Google’s cloud storage and file synchronization service, offering generous free storage and integration with Google Workspace. The adapter uses OAuth 2.0 for secure authentication.
Capabilities
Section titled “Capabilities”- ✅ Browse folders and files
- ✅ Upload files
- ✅ Download files
- ✅ Create folders
- ✅ Delete files/folders
- ✅ Search files
- ✅ View file metadata
- 🚧 Move files (in progress)
- 🚧 Copy files (in progress)
Prerequisites
Section titled “Prerequisites”- A Google account
- A Google Cloud project with Drive API enabled
- OAuth 2.0 credentials (Desktop app type recommended)
Required Configuration
Section titled “Required Configuration”Google OAuth Credentials (JSON)
Section titled “Google OAuth Credentials (JSON)”- Option key:
credentials - Type: File upload (JSON)
The JSON must be either a Desktop app (“installed”) or Web application (“web”) OAuth client downloaded from Google Cloud Console.
OAuth Configuration
Section titled “OAuth Configuration”Redirect URI
Section titled “Redirect URI”The adapter expects a localhost redirect URI:
- Default:
http://localhost:52847/oauth/callback
You must add this redirect URI to your Google Cloud OAuth client settings.
Required Scopes
Section titled “Required Scopes”The adapter requests these Google API scopes:
https://www.googleapis.com/auth/drive— Full Drive accesshttps://www.googleapis.com/auth/drive.file— Access to files created/opened by the apphttps://www.googleapis.com/auth/drive.metadata— View file metadata
Setup (Google Cloud Console)
Section titled “Setup (Google Cloud Console)”1. Create a Google Cloud Project
Section titled “1. Create a Google Cloud Project”- Go to Google Cloud Console
- Click the project dropdown => New Project
- Enter a project name (e.g.,
Blober Drive Access) - Click Create
2. Enable the Google Drive API
Section titled “2. Enable the Google Drive API”- Go to APIs & Services => Library
- Search for “Google Drive API”
- Click on it and click Enable
3. Configure OAuth Consent Screen
Section titled “3. Configure OAuth Consent Screen”- Go to APIs & Services => OAuth consent screen
- Select External (unless you have Google Workspace)
- Fill in required fields:
- App name: Your app name
- User support email: Your email
- Developer contact: Your email
- Click Save and Continue
- Add scopes (optional for testing)
- Add test users (your Google account email)
- Complete the wizard
4. Create OAuth Credentials
Section titled “4. Create OAuth Credentials”- Go to APIs & Services => Credentials
- Click Create Credentials => OAuth client ID
- Select Desktop app (recommended for Blober Desktop)
- Enter a name (e.g.,
Blober Desktop) - Click Create
5. Add Redirect URI
Section titled “5. Add Redirect URI”- Click on your newly created OAuth client
- Under Authorized redirect URIs, add:
http://localhost:52847/oauth/callback
- Click Save
6. Download Credentials
Section titled “6. Download Credentials”- Click the download button (⬇️) next to your OAuth client
- Save the JSON file
7. Configure in Blober
Section titled “7. Configure in Blober”- In Blober, go to Workflows => New Workflow
- Select Google Drive as source or destination
- Upload your downloaded JSON credentials file
- Click Authorize Google Drive Access
- Sign in with your Google account in the browser
- Grant the requested permissions
- Return to Blober
File Types
Section titled “File Types”Google Drive handles these file types:
| Type | Description | Export Format |
|---|---|---|
| Regular files | Documents, images, videos | As-is |
| Google Docs | Google Docs documents | .docx |
| Google Sheets | Google Sheets spreadsheets | .xlsx |
| Google Slides | Google Slides presentations | .pptx |
| Google Forms | Form definitions | Not downloadable |
Permissions & Privacy
Section titled “Permissions & Privacy”When you connect Google Drive, Blober requests these permissions:
- View files: Read file names and metadata
- Download files: Download file contents
- Upload files: Create new files
- Delete files: Remove files you own
Blober will never:
- Access files from other apps without permission
- Modify files without your explicit action
- Share your data with third parties
Common Issues
Section titled “Common Issues””redirect_uri_mismatch”
Section titled “”redirect_uri_mismatch””- Ensure the redirect URI in Google Cloud Console matches exactly:
- Scheme:
http(nothttps) - Host:
localhost - Port:
52847 - Path:
/oauth/callback
- Scheme:
”No localhost redirect URI found”
Section titled “”No localhost redirect URI found””- Edit your OAuth client in Google Cloud Console
- Add
http://localhost:52847/oauth/callbackto Authorized redirect URIs
”Authentication Failed”
Section titled “”Authentication Failed””- Try disconnecting and reconnecting
- Clear browser cookies for accounts.google.com
- Check you’re signing into the correct Google account
”Permission Denied”
Section titled “”Permission Denied””- Re-authorize to refresh permissions
- Check if files are owned by you or shared with you
- Verify the OAuth consent screen is configured correctly
”Files Not Showing”
Section titled “”Files Not Showing””- Refresh the file list
- Check you’re in the correct folder
- Verify files aren’t in Trash
Limitations
Section titled “Limitations”Storage
Section titled “Storage”- Free tier: 15 GB (shared with Gmail and Google Photos)
- Maximum file size: 5 TB per file
- Daily upload limit: 750 GB
API Quotas
Section titled “API Quotas”- Google imposes rate limits on API requests
- Blober handles rate limiting automatically
- Large operations may take time due to throttling
Google Workspace Files
Section titled “Google Workspace Files”- Google Docs/Sheets/Slides are exported to Microsoft Office formats
- Some formatting may differ after export
- Google Forms cannot be downloaded
Best Practices
Section titled “Best Practices”Organization
Section titled “Organization”- Use descriptive folder and file names
- Organize files by project or category
- Use starred items for quick access
Storage Management
Section titled “Storage Management”- Regularly clean up unused files
- Empty Trash to free up space
- Consider Google One for more storage
Security
Section titled “Security”- Never share your OAuth credentials JSON file
- Periodically review connected apps in Google Account settings
- Revoke access for apps you no longer use
Search Syntax
Section titled “Search Syntax”Use Google Drive’s powerful search in Blober:
| Query | Description |
|---|---|
filename:report | Files with “report” in the name |
type:pdf | PDF files only |
owner:me | Files you own |
modified:last7days | Recently modified |