Google Analytics 数据报告助手
启用并调用 Google Analytics Data API 创建自定义报告。
文档明确说明使用 Google Analytics 只读范围，并展示 API、凭据和数据访问流程；官方归属和 Apache-2.0 许可证也可追溯。但 `gcloud services enable --quiet` 会产生外部配置变更且没有逐次确认或回滚说明，`cloud-platform` 范围相对宽泛，也未充分说明分析数据的敏感性、传输边界、凭据隔离和失败恢复，因此扣分。
主路径包括 API 启用、ADC 配置、客户端安装、报告查询和兼容性检查，示例之间基本一致。静态材料没有测试、CI 覆盖或可复现执行证据，多数语言缺少超时、重试、分页、空结果和结构化错误处理；异常时主要依赖原生错误输出，因此按静态上限并扣分。
目标场景、支持的语言、常用指标维度及兼容性检查用途较清晰。未明确非适用场景、触发排除条件、权限前提、属性类型限制或中文使用方式；核心能力依赖 Google Cloud、ADC 和相关网络可达性，未提供面向中国大陆网络环境的替代路径，因此扣分。
目录结构清楚，主文档通过语言专用 references 实现了基本渐进式披露，并提供安装前提、示例、官方资料入口、许可证和仓库维护线索。缺少明确版本锁定、变更记录、兼容性矩阵、维护责任人、更新策略、FAQ 和系统化故障排查，部分示例使用 `LATEST_LIBRARY_VERSION`，因此扣分。
技能能直接指导用户启用 API、安装客户端、运行基础报告并检查指标维度兼容性，核心价值明确。输出主要是简单控制台打印，未覆盖过滤、分页、配额、采样、空结果、权限失败或生产报告格式；示例未静态外部验证，完成真实任务仍需补充配置和工程处理，因此扣分。
材料包含可审计的命令、代码、包名、API 方法和官方参考入口，具备有限的主材料可核查性。提供的文件中没有测试套件、CI 结果、提交级验证记录或第三方执行证据，且本次未执行任何代码，因此无法支持更高分。
- 执行 API 启用和 ADC 登录前，应确认目标 Cloud 项目、账户、授权范围及组织策略；`--quiet` 不等于风险确认。
- 不要把示例中的日期、属性 ID、指标维度组合直接用于生产；应先验证属性权限、字段兼容性、配额、隐私要求和实际 API 版本。
- 在中国大陆网络或无法稳定访问 Google 服务的环境中，核心流程可能不可用；文档未提供网络、代理或替代方案。
- 安装依赖未锁定版本，生产环境应使用经过审查的版本和依赖锁文件。
这个 Skill 能做什么，适合哪些场景？
此技能用于通过 Google Analytics Data API v1beta 访问报告数据。它指导用户使用 gcloud 启用 API、配置应用默认凭据，并通过官方客户端库创建报告。技能涵盖常见指标和维度，以及查询前的兼容性检查。它适合需要程序化读取 Google Analytics 属性数据的开发者和数据分析人员。
检查 Google Cloud CLI 是否可用，指导启用 analyticsdata.googleapis.com 并验证启用状态；指导配置包含 cloud-platform 和 analytics.readonly 范围的应用默认凭据；使用官方客户端库构造并运行报告请求；查询如 activeUsers、sessions、screenPageViews 等指标，以及 city、date 等维度；使用 getMetadata() 和 checkCompatibility() 检查字段及指标、维度组合的有效性。
- 需要从 Google Analytics 属性按城市和日期查询活跃用户、会话等数据的开发者。
- 需要在 Google Cloud 项目中首次启用 Analytics Data API 的用户。
- 需要用 Python、Java、PHP、Node.js、Go、.NET 或 Ruby 集成报告 API 的工程师。
- 在报告请求返回 INVALID_ARGUMENT 且怀疑指标与维度不兼容时进行预检查的分析人员。
- 需要构建自定义仪表板或自动化报告流程的团队。
这个 Skill 有哪些优点和局限？
- 覆盖 API 启用、身份验证、报告查询和兼容性检查的完整入门流程。
- 支持 Python、Java、PHP、Node.js、Go、.NET 和 Ruby 客户端库。
- 提供可运行的 Python 报告和兼容性检查示例。
- 明确要求使用 v1beta API，并列出常见指标和维度。
- 必须具备 Google Cloud 项目、Google Analytics 属性 ID、相应权限和配额。
- 依赖 Google Cloud CLI、应用默认凭据和对应语言的客户端库。
- 语言特定安装指南的具体内容未在提供的源材料中展开。
- 源材料未提供测试套件或已验证的平台清单。
- 示例使用 v1beta，且文档未说明迁移到其他 API 版本的步骤。
如何安装这个 Skill？
在支持 Agent Skills 的客户端中运行 npx skills add google/skills，然后从仓库中选择 skills/analytics/google-analytics-data-api-basics。README 未提供将单个技能复制到特定客户端目录的额外步骤。选择具体编程语言后，还必须阅读该语言对应的 references/ 安装指南；这些指南的内容未包含在源材料中。
如何使用这个 Skill？
示例触发请求：“帮助我启用 Google Analytics Data API，并用 Python 查询某个属性按城市和日期分组的 activeUsers 与 sessions。”使用前确保已安装 Google Cloud CLI，并执行 gcloud services enable analyticsdata.googleapis.com --quiet、gcloud services list --enabled --filter="analyticsdata.googleapis.com" 和 gcloud auth application-default login --scopes="https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/analytics.readonly"。Python 示例还需要执行 pip install google-analytics-data，并将示例中的 YOUR-PROPERTY-ID 替换为实际属性 ID。