SuperAPI AI 工具集

google-analytics

数据与分析

查看项目

更新于 10-16 07:15

技能介绍

用途:通过 Google Analytics 4 Data API 查询报告、实时数据以及维度与指标。

主要能力:可运行报告(runReport)、运行实时报告(runRealtimeReport),以及列出属性(properties)。报告支持指定日期范围、维度、指标和返回条数。

使用方式:需设置环境变量 GOOGLE_ACCESS_TOKEN,即具有 Analytics 范围的 OAuth 2.0 访问令牌。调用时把 PROPERTY_ID 替换为你的 GA4 数字属性 ID;列出属性时把 ACCOUNT_ID 替换为账户 ID。访问令牌需具备 https://www.googleapis.com/auth/analytics.readonly 范围。

示例命令: 运行报告:curl -s -X POST -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" -H "Content-Type: application/json" "https://analyticsdata.googleapis.com/v1beta/properties/PROPERTY_ID:runReport" -d '{"dateRanges":[{"startDate":"7daysAgo","endDate":"today"}],"dimensions":[{"name":"pagePath"}],"metrics":[{"name":"activeUsers"},{"name":"screenPageViews"}],"limit":10}' 实时报告:curl -s -X POST -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" -H "Content-Type: application/json" "https://analyticsdata.googleapis.com/v1beta/properties/PROPERTY_ID:runRealtimeReport" -d '{"dimensions":[{"name":"country"}],"metrics":[{"name":"activeUsers"}],"limit":10}' 列出属性:curl -s -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" "https://analyticsadmin.googleapis.com/v1beta/properties?filter=parent:accounts/ACCOUNT_ID"

适用场景:需要以命令行或脚本方式获取 GA4 网站/应用流量、页面浏览、活跃用户及实时国家分布等分析数据时。

限制:需自行准备有效访问令牌与属性 ID;资料未提供令牌获取流程、配额、错误处理及收费信息。