Files
soleprint/docs/data/en/artery-google.md
2026-04-14 10:32:05 -03:00

1.2 KiB

Google Vein

Status: building

Connects soleprint to Google services. OAuth2 flow is implemented. Sheets read access works. Calendar and Drive are next.


What Works

OAuth2 authentication -- full flow with authorization URL generation, code exchange, token refresh, and user identity extraction. Supports both identity (OpenID Connect) and API access scopes.

Google Sheets -- read-only access to spreadsheet data.

Configuration

Create a .env file in the vein directory:

GOOGLE_CLIENT_ID=your-client-id
GOOGLE_CLIENT_SECRET=your-client-secret
GOOGLE_REDIRECT_URI=http://localhost:12000/artery/google/oauth/callback
API_PORT=8003

You need a Google Cloud project with OAuth consent screen configured and credentials created.

OAuth Scopes

Identity scopes (default):

  • openid
  • userinfo.email
  • userinfo.profile

API scopes (added when needed):

  • spreadsheets.readonly
  • drive.readonly

What's Coming

  • Calendar integration
  • Drive file browsing and download
  • Full Sheets write support

Configuration details will be added as these integrations mature.

Running Standalone

cd soleprint/artery/veins/google
python run.py
# Runs on port 8003