openclaw-workspace/skills/api-gateway/references/google-analytics-data.md

Google Analytics Data Routing Reference

App name: google-analytics-data Base URL proxied: analyticsdata.googleapis.com

API Path Pattern

/google-analytics-data/v1beta/{endpoint}

Common Endpoints

Run Report

POST /google-analytics-data/v1beta/properties/{propertyId}:runReport
Content-Type: application/json

{
  "dateRanges": [{"startDate": "30daysAgo", "endDate": "today"}],
  "dimensions": [{"name": "city"}],
  "metrics": [{"name": "activeUsers"}]
}

Run Realtime Report

POST /google-analytics-data/v1beta/properties/{propertyId}:runRealtimeReport
Content-Type: application/json

{
  "dimensions": [{"name": "country"}],
  "metrics": [{"name": "activeUsers"}]
}

Batch Run Reports

POST /google-analytics-data/v1beta/properties/{propertyId}:batchRunReports
Content-Type: application/json

{
  "requests": [
    {
      "dateRanges": [{"startDate": "7daysAgo", "endDate": "today"}],
      "dimensions": [{"name": "country"}],
      "metrics": [{"name": "sessions"}]
    },
    {
      "dateRanges": [{"startDate": "7daysAgo", "endDate": "today"}],
      "dimensions": [{"name": "deviceCategory"}],
      "metrics": [{"name": "sessions"}]
    }
  ]
}

Get Metadata (available dimensions/metrics)

GET /google-analytics-data/v1beta/properties/{propertyId}/metadata

Common Report Examples

Page Views by Page

{
  "dateRanges": [{"startDate": "30daysAgo", "endDate": "today"}],
  "dimensions": [{"name": "pagePath"}],
  "metrics": [{"name": "screenPageViews"}],
  "orderBys": [{"metric": {"metricName": "screenPageViews"}, "desc": true}],
  "limit": 10
}

Users by Country

{
  "dateRanges": [{"startDate": "30daysAgo", "endDate": "today"}],
  "dimensions": [{"name": "country"}],
  "metrics": [{"name": "activeUsers"}, {"name": "sessions"}],
  "orderBys": [{"metric": {"metricName": "activeUsers"}, "desc": true}]
}

Traffic Sources

{
  "dateRanges": [{"startDate": "30daysAgo", "endDate": "today"}],
  "dimensions": [{"name": "sessionSource"}, {"name": "sessionMedium"}],
  "metrics": [{"name": "sessions"}, {"name": "conversions"}]
}

Device Breakdown

{
  "dateRanges": [{"startDate": "7daysAgo", "endDate": "today"}],
  "dimensions": [{"name": "deviceCategory"}],
  "metrics": [{"name": "activeUsers"}, {"name": "sessions"}, {"name": "bounceRate"}]
}

Daily Sessions Trend

{
  "dateRanges": [{"startDate": "30daysAgo", "endDate": "today"}],
  "dimensions": [{"name": "date"}],
  "metrics": [{"name": "sessions"}, {"name": "activeUsers"}],
  "orderBys": [{"dimension": {"dimensionName": "date"}}]
}

Common Dimensions

• date, dateHour, dateHourMinute
• country, city, region
• deviceCategory, browser, operatingSystem
• pagePath, pageTitle, landingPage
• sessionSource, sessionMedium, sessionCampaignName
• eventName

Common Metrics

• activeUsers, newUsers, totalUsers
• sessions, sessionsPerUser
• screenPageViews, screenPageViewsPerSession
• bounceRate, averageSessionDuration
• conversions, eventCount

Date Formats

• Relative: today, yesterday, 7daysAgo, 30daysAgo
• Absolute: 2026-01-01

Notes

• Authentication is automatic - the router injects the OAuth token
• Property IDs are numeric (e.g., 521310447 from URL p521310447)
• GA4 properties only (Universal Analytics not supported)
• Use metadata endpoint to discover available dimensions/metrics
• Results are paginated with limit and offset
• This API is for running reports only - listing properties requires the Admin API

Resources

• API Overview
• Run Report
• Run Realtime Report
• Batch Run Reports
• Get Metadata