Google Workspace Api

Google Workspace APIs give programmatic access to Gmail, Calendar, Drive, Docs, and Sheets — the full productivity suite. For agents: Service Account with domain-wide delegation is the recommended server-side pattern (no user OAuth flow) — impersonate any Workspace user and access their data. Gmail API for reading and sending email, Calendar API for scheduling, Drive API for file management, Sheets API for data pipelines (Sheets as a lightweight database), and Docs API for document automation. google-api-python-client is the standard Python interface. Free with Google Workspace subscription. Confidence is docs-derived.

REST endpoints per service: Gmail: gmail.googleapis.com/gmail/v1/users/{userId}/messages (list, get, send). Calendar: www.googleapis.com/calendar/v3/calendars/{calendarId}/events. Drive: www.googleapis.com/drive/v3/files. Sheets: sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}. Docs: docs.googleapis.com/v1/documents/{documentId}. Python SDK: gmail = build("gmail","v1",credentials=creds); service.users().messages().list(userId="me",q="is:unread").execute(). Sheets: service.spreadsheets().values().get(spreadsheetId=id,range="Sheet1!A1:Z100").execute(). Drive: service.files().list(q="name contains 'report'",fields="files(id,name)").execute(). Calendar: service.events().insert(calendarId="primary",body={summary,start,end}).execute().

OAuth2: Service Account (recommended for agents) — download service-account.json from GCP Console, grant domain-wide delegation in Workspace Admin console, impersonate user: creds = service_account.Credentials.from_service_account_file(key_path, scopes=[...], subject=user_email). Or user OAuth2 flow (requires consent screen). API key: for public data only (not user-specific). HTTPS enforced. Scopes: granular per service (https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/drive, etc.). Domain-wide delegation requires Workspace admin approval.

Standard HTTP status codes with JSON error bodies ({error: {code, message, errors}}). 403 for quota exceeded or missing scope. 429 for rate limits. Gmail quota: 1B units/day (send email = 100 units). Calendar quota: 1M queries/day. Drive quota: 1B queries/day. Token refresh: google-auth handles automatically. Service Account: no token expiry concern (auto-refresh). Batch requests: POST /batch reduces API calls for bulk operations. Sheets API: A1 notation for range specification — column limits at 26,000 columns. Drive: resumable uploads for files > 5MB. Google Workspace uptime at workspace.google.com/status.

developers.google.com/workspace covers API references for all services, OAuth2 guide, Service Account setup, domain-wide delegation, and quickstart tutorials. Getting started: GCP project, enable APIs, create service account, domain-wide delegation — first API call in under 20 minutes (Workspace admin access required for DWD). google-api-python-client: pip install google-api-python-client google-auth. Community via Google Workspace Developer Community and Stack Overflow (google-api, gmail-api, google-sheets-api tags). Very mature APIs with extensive community resources.