Ga4 Data Api_数据分析 skill-PHP中文网

Ga4 Data Api

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

通过 Google Analytics Data API 查询 GA4 数据，分析趋势、国家/地区、来源、页面及转化情况。

GA4 Data API. 使用此技能通过 OAuth 用户授权设置和查询 GA4.

功能概述

GA4 Data API. 使用此技能通过 OAuth 用户授权设置和查询 GA4.是一项面向实际任务的技能，主要用于Default 方法.；Prefer OAuth 用户授权优先. . 使用脚本/install ga4 openclaw.sh + 脚本/ga4 q。

核心要点

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；

结果检查与注意事项

涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

GA4 数据 API

使用此技能通过 OAuth 用户授权方式配置并查询 GA4。

默认方法

优先采用 OAuth 用户授权。

常规流程请使用 scripts/install_ga4_openclaw.sh + scripts/ga4_query.py。

仅在明确需要无头模式（headless）或服务端访问时，才建议后续使用 服务账号（service accounts）。

硬性规则

配置前务必确认账号与权限
- 需明确询问：哪个 Google 账号可实际登录 GA，并具备 GA4 属性（Property）或账号（Account）的访问权限？
- 对于企业级/内部数据，默认不得直接启动服务账号配置流程。
如实说明阻塞点
- 若用户无法添加成员，请明确指出这是权限限制（permission blocker）。
- 若 OAuth 应用仍处于“测试中（Testing）”状态，请说明必须将该账号添加为测试用户（test user）。
- 若用户可见 GA4 属性但缺少管理员控制权限，请明确说明这是访问级别（access-level）问题，而非假装相关按钮被隐藏。

配置流程

步骤 1 — 确认访问模型

请询问或确认以下信息：

哪个 Google 账号拥有 GA 访问权限？
用户能否登录该账号？
GA4 Property ID 是什么？
Google Analytics Data API 是否已启用？
是否已存在桌面版 OAuth 客户端 JSON 文件（Desktop OAuth client JSON）？

步骤 2 — 安装并注入凭证

执行以下命令：

bash ~/.openclaw/workspace/skills/ga4-data-api/scripts/install_ga4_openclaw.sh

该命令将完成以下操作：

安装 Python 依赖项；
将 OAuth 客户端 JSON 文件复制至 ~/.config/openclaw/ga4-client.json；
将 GA4_PROPERTY_ID 写入 shell 配置文件。

步骤 3 — 首次授权

执行以下命令：

python3 ~/.openclaw/workspace/skills/ga4-data-api/scripts/ga4_query.py 
  --metrics activeUsers,sessions 
  --dimensions date 
  --start 7daysAgo 
  --end today 
  --pretty

浏览器将自动打开。用户必须选择 真正拥有 GA 访问权限的那个 Google 账号 进行授权。

授权成功后将生成：

~/.config/openclaw/ga4-token.json

步骤 4 — 查询示例

近期趋势分析：

python3 ~/.openclaw/workspace/skills/ga4-data-api/scripts/ga4_query.py 
  --metrics activeUsers,sessions 
  --dimensions date 
  --start 7daysAgo 
  --end yesterday 
  --pretty

国家分布：

python3 ~/.openclaw/workspace/skills/ga4-data-api/scripts/ga4_query.py 
  --metrics activeUsers 
  --dimensions country 
  --start 7daysAgo 
  --end yesterday 
  --limit 50 
  --pretty

流量来源分布：

python3 ~/.openclaw/workspace/skills/ga4-data-api/scripts/ga4_query.py 
  --metrics sessions 
  --dimensions sessionSourceMedium 
  --start 7daysAgo 
  --end yesterday 
  --limit 50 
  --pretty