Google Analytics 管理 API 助手
自动配置 Google Analytics 账户、属性及数据流。
文档说明了ADC、只读与编辑权限范围,并使用官方客户端库;但启用API、修改账户配置和管理Measurement Protocol secrets等操作缺少逐项用户确认、敏感数据处理、最小权限细化、变更预览与回滚方案,因此扣分。
安装和调用路径在多种语言中大体一致,且缺少依赖时会提示用户;但没有提交测试、CI覆盖、版本锁定、重试/配额处理或结构化错误反馈,静态证据不足,按规则不超过10分。
目标场景、API版本和支持语言较明确;但能力边界、触发排除条件、输入输出约定和异常环境说明不足,也未提供中文支持。核心功能依赖Google Cloud/Analytics服务,未说明中国大陆网络可达性,因此扣分。
文档分层清晰,提供多语言安装说明、快速示例、依赖前置条件、Apache-2.0许可证和官方维护入口;但没有明确维护责任人、版本策略、变更日志、完整限制说明或故障排查/FAQ,因此扣分。
账户摘要列表示例可直接作为起点,安装与认证步骤覆盖面较广;但描述的众多管理能力没有对应示例,配置变更、秘密和集成管理仍需大量补充,并缺乏结果验证证据,因此仅给中等分。
引用了官方客户端库和API文档,且代码示例可审阅;但没有提交测试、真实CI执行记录、第三方复核或独立可复现实验,主要结论仍来自文档自身,因此扣分。
- 执行gcloud启用API和ADC登录会改变本地或云端配置;应在操作前确认目标项目、账户、权限和影响范围。
- cloud-platform范围较宽,配置变更还需要analytics.edit;应避免默认授予超出任务所需的权限。
- Measurement Protocol secrets、访问绑定和用户删除等能力涉及敏感或不可逆影响,文档未提供轮换、审计、确认或恢复流程。
- Google Cloud与Analytics服务的网络可达性、配额、API版本和客户端包版本可能影响中国大陆用户的实际可用性。
这个 Skill 能做什么,适合哪些场景?
该技能帮助用户通过 Google Analytics Admin API 管理账户和属性配置。它指导启用 API、配置应用默认凭据,并列出当前用户可访问的账户及属性。它还覆盖数据流、自定义维度、转化事件、数据保留、Measurement Protocol 密钥以及 Firebase 和 Google Ads 集成。技能支持 Python、Java、PHP、Node.js、Go、.NET 和 Ruby 客户端库,并说明 v1beta 与 v1alpha 的适用范围。
指导用户使用 gcloud 启用 analyticsadmin.googleapis.com,并验证 API 是否已启用;配置带有 Cloud Platform 和 analytics.readonly 权限范围的应用默认凭据;说明配置变更所需的 analytics.edit 权限;通过官方客户端库调用 Admin API;使用 Python 示例列出账户摘要、账户名称及其子属性;指导管理账户、属性、数据流、自定义维度、转化事件、数据保留设置、Measurement Protocol 密钥及产品集成。
- Google Analytics 管理员需要批量查看当前用户可访问的账户和属性时。
- 开发者需要在 Google Cloud 项目中启用 Analytics Admin API 并配置本地认证时。
- 团队需要通过程序创建或管理属性、数据流、自定义维度和转化事件时。
- 运营人员需要配置数据保留或管理 Firebase、Google Ads 链接时。
- 开发者需要使用指定语言的官方 Google Analytics Admin 客户端库时。
这个 Skill 有哪些优点和局限?
- 覆盖 Google Analytics 账户和属性管理中的多项具体操作。
- 提供 API 启用、认证和 Python 列表查询的可执行示例。
- 列出七种客户端语言及对应的官方库包名。
- 明确区分 v1beta 稳定版本与 v1alpha 专属能力。
- 依赖 Google Cloud CLI、认证配置和网络访问。
- 大多数语言的设置指南仅被引用,具体内容未包含在本资料中。
- 未提供测试套件、错误处理示例或批量操作实现。
- 成本信息、精确安装目录和仅安装单个技能的命令未说明。
如何安装这个 Skill?
安装整个技能集合:
npx skills add google/skills安装过程中可选择此技能。README 未说明具体安装目录,也未提供仅安装该技能的独立命令。
如何使用这个 Skill?
可向兼容的 Agent Skills 客户端提出:"帮助我启用 Google Analytics Admin API,配置 ADC,并列出我可访问的账户和属性。" 使用前应确保 gcloud 可用;若使用 Python 快速开始,可运行 pip install google-analytics-admin,再使用文档中的 AnalyticsAdminServiceClient 和 list_account_summaries() 示例。若选择其他语言,必须先阅读对应的 references/ 设置指南;这些参考文件内容未随本资料提供。
这个 Skill 与同类方案有什么区别?
可在 Admin API 的 v1beta 与 v1alpha 之间选择:v1beta 被描述为最稳定版本,v1alpha 用于较新的功能,并包含一组仅限 alpha 的管理能力。