# 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:

```env
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

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