> ## Documentation Index > Fetch the complete documentation index at: https://docs.noxus.ai/llms.txt > Use this file to discover all available pages before exploring further. # Google Workspace > Connect to Google services with OAuth authentication Noxus integrates with Google Workspace services using OAuth 2.0 authentication, allowing you to access Gmail, Drive, Sheets, Docs, Calendar, and more. ## Supported Google Services | Service | Authentication | Key Capabilities | | :------------------ | :------------- | :-------------------------------------------------- | | **Gmail** | OAuth 2.0 | Send/receive emails, read threads, manage labels | | **Google Drive** | OAuth 2.0 | Upload/download files, folder management, sharing | | **Google Sheets** | OAuth 2.0 | Read/write data, create sheets, manage workbooks | | **Google Docs** | OAuth 2.0 | Create/edit documents, export formats | | **Google Calendar** | OAuth 2.0 | Create events, manage calendars, check availability | *** ## Authentication: OAuth 2.0 ### Description Google integrations use OAuth 2.0 to authenticate as a specific user. Users grant permission through Google's consent screen, and Noxus can then access the resources that user has permission to view or modify. ### When to Use * User-specific actions (sending email as a user) * Personal file access * Individual calendar management * Actions requiring user attribution * **Permission Type**: User-delegated * **Setup**: Interactive consent flow * **Access Scope**: User's accessible resources * **Best For**: Personal automation, user workflows ### Authentication Flow ```mermaid theme={null} sequenceDiagram participant U as User participant NF as Noxus Frontend participant G as Google OAuth participant NB as Noxus Backend participant GA as Google API Note over U,GA: Initial Setup U->>NF: Click "Connect Google Service" NF->>G: Redirect to Google consent screen G->>U: Display permission request U->>G: Approve permissions G->>NF: Return authorization code NF->>NB: Complete connection NB->>NB: Store tokens securely Note over U,GA: When running a flow... NB->>G: Request/refresh access token G->>NB: Return valid token NB->>GA: API request with token GA->>NB: Return data ``` ## Setup Process Go to Integrations in your Noxus workspace Choose the Google service (Gmail, Drive, Sheets, Docs, or Calendar) Click the Connect button Sign in with your Google account Review the requested permissions carefully Click "Allow" to grant permissions Connection is active and ready to use in flows *** ## Permissions by Service **Scopes Required:** * `gmail.readonly` - Read email and settings * `gmail.send` - Send email on your behalf * `gmail.modify` - Manage drafts and send email **Capabilities:** * Read emails and threads * Send emails * Create and manage labels * Search messages * Manage drafts **Scopes Required:** * `drive.readonly` - View files and folders * `drive.file` - View and manage files created by Noxus * `drive` - Full Drive access **Capabilities:** * Upload and download files * Create and manage folders * Share files and folders * Search Drive * Manage permissions **Scopes Required:** * `spreadsheets.readonly` - View spreadsheets * `spreadsheets` - Create and edit spreadsheets **Capabilities:** * Read sheet data * Write data to cells * Create new sheets * Format cells * Manage worksheets **Scopes Required:** * `documents.readonly` - View documents * `documents` - Create and edit documents **Capabilities:** * Read document content * Create new documents * Edit existing documents * Export to different formats **Scopes Required:** * `calendar.readonly` - View calendars * `calendar.events` - Manage events * `calendar` - Full calendar access **Capabilities:** * Create calendar events * Read event details * Update events * Check availability * Manage calendars *** ## Common Use Cases **Email Processing Workflows:** * Monitor inbox for specific emails * Automatically respond to inquiries * Extract data from email attachments * Route emails based on content * Send bulk personalized emails **Example Flow:** ```mermaid theme={null} graph LR A[Email Received] --> B[Extract Attachment] B --> C[Process Document] C --> D[Send Reply] ``` **File Management:** * Sync files to knowledge bases * Backup important documents * Process uploaded files * Generate and upload reports * Share files automatically **Example Flow:** ```mermaid theme={null} graph LR A[Schedule Trigger] --> B[Fetch from Drive] B --> C[Process Files] C --> D[Upload to KB] ``` **Data Workflows:** * Export data to Sheets * Import data for processing * Generate reports * Update tracking sheets * Analyze spreadsheet data **Example Flow:** ```mermaid theme={null} graph LR A[Data Source] --> B[Transform Data] B --> C[Write to Sheets] C --> D[Notify Team] ``` **Event Management:** * Schedule meetings automatically * Check availability * Send calendar invites * Sync events across systems * Automated reminders **Example Flow:** ```mermaid theme={null} graph LR A[New Request] --> B[Check Availability] B --> C[Create Event] C --> D[Send Invite] ``` *** ## Security Best Practices * Request only necessary scopes * Regularly review connected apps * Remove unused connections * Monitor access logs * Tokens stored encrypted * Automatic token refresh * Revoke access when needed * Audit token usage *** ## Troubleshooting **Possible Causes:** * Invalid Google account * Permissions not granted * OAuth flow interrupted * Network connectivity issues **Solutions:** * Try reconnecting with a different account * Ensure all permissions are approved * Complete the OAuth flow without closing windows * Check network connection **Possible Causes:** * Missing required scopes * User revoked access * Resource access restrictions * Admin disabled app access **Solutions:** * Reconnect to grant additional scopes * Check Google account permissions * Verify resource sharing settings * Contact Google Workspace admin **Possible Causes:** * API rate limits reached * Too many concurrent requests * Daily quota exceeded **Solutions:** * Implement rate limiting in flows * Reduce request frequency * Use batch operations when available * Upgrade Google Workspace plan if needed *** ## Next Steps Connect Outlook, Teams, and OneDrive Integrate Jira and Confluence Browse the complete catalog