Google Analytics 管理接口
通过 Google Analytics Admin API 管理账号、媒体资源、数据流、转化事件和产品关联。
技能说明
Google 官方技能，适合 GA4 配置自动化和排查。需要 gcloud、Application Default Credentials 与相应权限；修改配置需 analytics.edit，不负责报表查询或前端埋点安装。
关于此技能
Google 官方 Agent Skill，围绕 Google Analytics Admin API 管理账号、媒体资源、数据流、转化事件和产品关联。
核心能力
API 与认证准备
启用 Analytics Admin API，使用 Application Default Credentials 和合适的只读或编辑权限。
账号与媒体资源管理
列出账号与媒体资源，创建或管理属性，并查询账号变更记录。
数据流与事件配置
管理数据流、自定义维度与指标、转化事件、关键事件和 Measurement Protocol 密钥。
产品关联
配置 Firebase 与 Google Ads 等产品的关联，保持分析设置一致。
适用场景
批量查看或配置 GA4 资源
需要列出账号、媒体资源和数据流，或按规则初始化分析配置时使用。
维护转化与自定义字段
管理转化事件、自定义维度、指标和数据保留设置。
检查产品关联与变更
维护 Firebase/Google Ads 关联，或排查谁在什么时候改过配置。
使用步骤
- 01
启用接口
通过 gcloud 启用 analyticsadmin.googleapis.com，并确认项目权限。
- 02
准备授权
使用 analytics.readonly 进行读取；执行配置修改前明确申请 analytics.edit。
- 03
确认版本
常规功能优先使用 v1beta；只有需要时才使用文档列明的 v1alpha 能力。
- 04
执行目标操作
先确认目标账号和媒体资源，再调用官方客户端库完成配置。
- 05
复核结果
核对目标、权限和变更记录，不把管理接口当作前端埋点或报表接口。
常见问题
读取和修改需要什么权限？+
读取可使用 cloud-platform 与 analytics.readonly；修改账号或媒体资源配置需要 analytics.edit，并应在执行前确认范围。
它能直接生成报表吗？+
不能。报表查询应使用 Google Analytics Data API；本技能主要管理账号和媒体资源配置。
能安装前端追踪代码吗？+
不能。它负责 Admin API 配置，不负责网站或 App 的埋点安装。
需要先安装 gcloud 吗？+
建议先准备 Google Cloud CLI；如果本机没有 gcloud，应先完成安装和登录，再启用 API。
npx skills add google/skills；安装时选择 skills/analytics/google-analytics-admin-api-basics；Python 客户端可安装 google-analytics-admin