​

Google Workspace Toolkit

​

Overview

​

Available Services

​

Gmail

• Email Management: Send, read, and manage emails
• Label Management: Organize emails with labels
• Contact Access: Manage Gmail contacts
• Search: Advanced email search capabilities

​

Google Drive

• File Management: Upload, download, and organize files
• Folder Operations: Create and manage folder structures
• Sharing Controls: Manage file permissions and sharing
• Search: Find files using advanced search

​

Google Docs

• Document Creation: Create and edit text documents
• Content Management: Insert text, images, and formatting
• Collaboration: Real-time editing and commenting
• Export: Export to various formats

​

Google Sheets

• Spreadsheet Management: Create and edit spreadsheets
• Data Analysis: Perform calculations and data manipulation
• Chart Creation: Generate charts and visualizations
• Formula Support: Use Google Sheets formulas

​

Google Slides

• Presentation Creation: Create and edit presentations
• Slide Management: Add, remove, and organize slides
• Content Insertion: Add text, images, and media
• Template Support: Use and create presentation templates

​

Google Calendar

• Event Management: Create and manage calendar events
• Scheduling: Handle meeting scheduling and invitations
• Calendar Access: View and manage multiple calendars
• Time Management: Handle time zones and recurring events

​

Setup Instructions

​

Cloud Customers (Odin Hosted)

1. Connect Google Account
   • Users can connect their Google accounts directly from their agent settings
   • OAuth flow uses Odin’s pre-configured Google app
   • Access to Gmail, Drive, Docs, Sheets, Slides, and Calendar
   • No additional setup or credentials needed

​

On-Premise Customers (Self-Hosted)

​

Prerequisites

• Google Cloud Console account
• Google Workspace account (or personal Google account)
• Odin AI Super Admin access

​

Step 1: Google Cloud Console Setup

1. Go to Google Cloud Console
   • Visit console.cloud.google.com
   • Create a new project or select existing one
2. Enable Required APIs
   • Navigate to “APIs & Services” > “Library”
   • Enable the following APIs:
     • Gmail API (for Gmail integration)
     • Google Drive API (for Drive, Docs, Sheets, Slides)
     • Google Docs API (for document management)
     • Google Sheets API (for spreadsheet management)
     • Google Slides API (for presentation management)
     • Google Calendar API (for calendar integration)
3. Create OAuth Credentials
   • Go to “APIs & Services” > “Credentials”
   • Click “Create Credentials” > “OAuth 2.0 Client ID”
   • Choose “Web application” as application type
   • Add authorized redirect URI: https://your-odin-domain.com/user/integrations/google/oauth/callback
4. Configure OAuth Consent Screen
   • Go to “APIs & Services” > “OAuth consent screen”
   • Choose “External” user type (or “Internal” for Google Workspace)
   • Fill in required app information
   • Add required OAuth scopes (see OAuth Scopes section below)

​

Step 2: Get Credentials

1. Copy Client ID and Secret
   • From the OAuth 2.0 Client ID page
   • Copy the Client ID and Client Secret
2. Note the Redirect URI
   • Ensure it matches your Odin installation URL

​

Step 3: Configure in Odin

1. Access Super Admin Panel
   • Log in to your Odin instance as Super Admin
   • Navigate to Super Admin > Toolkits
2. Add Google Workspace Configuration
   • Find Google Workspace in the toolkit list
   • Enter the following credentials:
     • Google Client ID: Your OAuth Client ID
     • Google Client Secret: Your OAuth Client Secret
     • Google Redirect URI: Your configured redirect URI
3. Save Configuration
   • Click “Save” to store the configuration

​

Best Practices

​

Security

• Use minimal required scopes
• Regularly rotate OAuth credentials
• Monitor API usage and access logs
• Implement proper error handling
• Use service accounts for server-to-server authentication when possible

​

Performance

• Use batch operations when possible
• Implement rate limiting to respect API limits
• Cache frequently accessed data
• Use appropriate file formats for the task
• Optimize queries and requests

​

User Experience

• Provide clear error messages
• Implement retry mechanisms for failed operations
• Use consistent naming conventions
• Respect user preferences and settings
• Provide progress indicators for long operations

​

Rate Limits

• 1,000 requests per 100 seconds per user for most APIs
• 10,000 requests per day for some APIs
• Quota units vary by API and operation type

​

Troubleshooting

​

Common Issues

Error: invalid_grant

• Solution: Verify OAuth credentials and redirect URI

Error: insufficient_permission

• Solution: Ensure all required OAuth scopes are granted

Error: rateLimitExceeded

• Solution: Implement exponential backoff and reduce request frequency

Error: file_not_found

• Solution: Verify file ID and user access permissions

​

Debug Tips

1. Test API Access
   • Use Google’s OAuth 2.0 Playground to test credentials
   • Verify scopes are properly granted
   • Check API quotas in Google Cloud Console
2. Monitor API Usage
   • Review Google Cloud Console for API usage statistics
   • Monitor quota consumption
   • Set up alerts for quota approaches
3. Check Service Status
   • Verify Google services are operational
   • Check for maintenance windows
   • Review Google Workspace Status page

​

Related Toolkits

• Microsoft 365 - Alternative productivity suite
• Dropbox - Alternative file storage
• Slack - Team communication
• Calendar Integration - Meeting scheduling

​

Support