What problem does it solve? Setting up Google API access normally requires duplicating OAuth setup, credential management, and error handling logic across every Google service integration. This shared resource library centralizes authentication, configuration checks, and troubleshooting references so Gmail, Docs, Sheets, and Calendar integrations all use one unified token and one credentials source. ## Core Features & Use Cases - Unified OAuth Flow: A single google_auth.py script handles login, logout, token refresh, and status checks across Gmail, Docs, Sheets, Calendar, Drive, Tasks, and Slides with one consent grant. - Pre-flight Configuration Validation: check_google_config.py returns structured JSON with an ai_action field (proceed, install_dependencies, need_credentials, need_login) so an AI agent can automatically diagnose and fix setup issues. - Shared Troubleshooting References: Setup guides and error-handling documentation cover HTTP 401/403/404/429 errors, scope issues, rate limits, and token refresh failures. - Use Case: When a user asks to send an email and the Gmail skill fails, the agent runs the config check, reads the ai_action field, and either installs dependencies, guides credential creation in Google Cloud Console, or triggers the login flow automatically. ## Quick Start Run the Google configuration check script with JSON output to verify that credentials, dependencies, and the OAuth token are ready before using any Google service.
