谷歌分析API集成

技能简介

该技能通过Maton网关代理访问Google Analytics API，支持Admin API（管理账户、媒体资源、数据流）和Data API（运行会话、用户、页面浏览量等报表查询）。采用托管OAuth模式，无需自行维护令牌刷新逻辑。

业务背景

市场与运营团队无需自建数据管道，即可直接调取Google Analytics的账户配置与核心报表数据。通过托管OAuth模式，省去令牌维护成本，让业务人员专注于分析用户行为、转化路径及流量质量，快速支撑营销决策与效果复盘。

落地案例：某电商运营负责人需要每周向管理层汇报各渠道转化表现。他使用该技能指定日期范围与维度组合（如来源/媒介+会话数+购买事件），直接拉取GA4报表JSON数据，导入内部看板生成趋势图。若需排查某站点数据异常，还可调用Admin API核查该属性的数据流配置是否完整，无需等待技术排期开发接口。

能做什么

• 列举账户摘要、媒体资源详情及数据流配置
• 创建和管理GA4属性与数据流
• 按维度/指标组合运行自定义报表
• 查询活跃用户、转化事件等核心指标

使用说明

1. 获取API密钥

1. 注册或登录maton.ai
2. 进入设置页复制API密钥
3. 设置环境变量：export MATON_API_KEY="YOUR_API_KEY"

2. 创建OAuth连接

Admin API与Data API需分别建立连接：

# Admin API连接（用于账户管理）
curl -s -X POST "https://ctrl.maton.ai/connections" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MATON_API_KEY" \
  -d '{"app": "google-analytics-admin"}'

# Data API连接（用于报表查询）
curl -s -X POST "https://ctrl.maton.ai/connections" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MATON_API_KEY" \
  -d '{"app": "google-analytics-data"}'

返回的url需在浏览器中打开完成Google授权。

3. 调用接口

# 列举账户摘要
curl -s -X GET "https://gateway.maton.ai/google-analytics-admin/v1beta/accountSummaries" \
  -H "Authorization: Bearer $MATON_API_KEY"

# 运行报表（替换{propertyId}为实际属性ID）
curl -s -X POST "https://gateway.maton.ai/google-analytics-data/v1beta/properties/{propertyId}:runReport" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MATON_API_KEY" \
  -d '{
    "dateRanges": [{"startDate": "30daysAgo", "endDate": "today"}],
    "dimensions": [{"name": "city"}],
    "metrics": [{"name": "activeUsers"}]
  }'

多连接场景下可通过Maton-Connection头指定特定连接。

输入与输出

见下方输入与输出表格。

风险提示

• API密钥泄露可能导致数据被未授权访问，建议存储于密钥管理系统
• Admin API与Data API权限分离，需确保对应连接已激活
• Google OAuth授权过期后需重新走连接创建流程
• 高频调用可能触发Google API配额限制

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/rich-song/google-analytics-api/SKILL.md
来源类型：GitHub仓库