updated docs
This commit is contained in:
55
docs/data/en/artery-google.md
Normal file
55
docs/data/en/artery-google.md
Normal file
@@ -0,0 +1,55 @@
|
||||
# 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
|
||||
```
|
||||
Reference in New Issue
Block a user