Edit a post

gblog edit --blog-id YOUR_BLOG_ID --post-id POST_ID --content ./updated.html

Delete a post

gblog delete --blog-id YOUR_BLOG_ID --post-id POST_ID


## Setup

### 1. Google Cloud Console Setup

1. Go to [Google Cloud Console](https://console.cloud.google.com/)
2. Create a project or select existing
3. Enable **Blogger API v3**
4. Go to **APIs & Services → Credentials**
5. Create **OAuth 2.0 Client ID** (Desktop application type)
6. Add redirect URIs:
   - `http://localhost:8085/oauth2callback`
   - `http://localhost:8080/oauth2callback`
7. Download credentials JSON

### 2. Local Setup

```bash
# Create config directory
mkdir -p ~/.config/gblog

# Save credentials
cp ~/Downloads/client_secret_*.json ~/.config/gblog/credentials.json

# Run authentication
gblog auth

3. Authentication

The first time you run gblog auth, it will:

Open a browser for Google OAuth
Request permissions for Blogger
Save refresh token to ~/.config/gblog/token.json

Commands

Authentication

gblog auth                    # Authenticate with Google
gblog auth --status          # Check auth status
gblog auth --logout          # Clear saved tokens

Blog Management

gblog list-blogs             # List all your blogs
gblog get-blog --id BLOG_ID  # Get blog details

Post Management

# List posts
gblog list-posts --blog-id BLOG_ID

# Create post
gblog post \
  --blog-id BLOG_ID \
  --title "Post Title" \
  --content ./content.html \
  --labels "AI, Tutorial" \
  --draft

# Edit post
gblog edit \
  --blog-id BLOG_ID \
  --post-id POST_ID \
  --title "Updated Title" \
  --content ./updated.html

# Delete post
gblog delete --blog-id BLOG_ID --post-id POST_ID

# Get post
gblog get-post --blog-id BLOG_ID --post-id POST_ID

Monitoring

# Monitor new posts (poll every 5 minutes)
gblog monitor --blog-id BLOG_ID --interval 300

# Get post statistics
gblog stats --blog-id BLOG_ID

HTML Content Format

Posts support full HTML. Example structure:

<div style="font-family: Arial, sans-serif; line-height: 1.8;">
  <h1 style="color: #27ae60;">Post Title</h1>
  
  <p>Your content here...</p>
  
  <div style="background: #f5f5f5; padding: 20px; border-radius: 8px;">
    <h3>Call to Action</h3>
    <a href="...">Subscribe</a>
  </div>
</div>

Configuration Files

File	Purpose
`~/.config/gblog/credentials.json`	OAuth client credentials
`~/.config/gblog/token.json`	Saved access/refresh tokens
`~/.config/gblog/config.json`	User preferences

Environment Variables

export GBLOG_CREDENTIALS_PATH=/path/to/credentials.json
export GBLOG_TOKEN_PATH=/path/to/token.json
export GBLOG_DEFAULT_BLOG_ID=your-blog-id

Error Handling

Common errors and solutions:

Error	Solution
`invalid_grant`	Run `gblog auth` again
`insufficient_permissions`	Check Blogger API is enabled
`blog not found`	Verify blog ID is correct
`rate limit exceeded`	Wait 60 seconds and retry

API Reference

Uses Blogger API v3:

Base URL: https://www.googleapis.com/blogger/v3
Documentation: https://developers.google.com/blogger/docs/3.0/reference

Scripts

scripts/gblog.py - Main CLI script
scripts/auth.py - OAuth authentication
scripts/blogger_api.py - API wrapper

gblog

gblog - Blogger CLI

Quick Start