核心功能
gws-admin-reports 是面向 Google Workspace 管理员的命令行审计工具，基于 Admin SDK Reports API 提供五大核心能力：
1. 活动审计 (`activities`)：检索管理员操作、Google Drive 等应用的详细活动日志，支持按应用类型、时间范围筛选
2. 实时监控 (`watch`/`channels.stop`)：建立推送通知通道，实时接收账户活动告警
3. 客户级用量报告 (`customerUsageReports`)：获取整个组织的应用使用统计和属性聚合
4. 实体用量报告 (`entityUsageReports`)：按实体（如设备、浏览器）统计用户使用情况
5. 用户级用量报告 (`userUsageReport`)：细化到具体用户的活动统计与行为分析
显著优点
- 官方 SDK 封装：基于 Google 官方 Admin SDK，API 稳定性与数据权威性有保障
- 灵活查询模式：支持列表查询、条件过滤、JSON 参数注入，便于脚本化集成
- 实时推送能力：通过
watch机制替代轮询，降低 API 调用成本与延迟 - 多维度覆盖：从客户全景到单个用户，从活动日志到用量统计，满足合规审计、成本优化、安全监控等多场景
潜在局限
- 权限门槛高：需 Workspace 超级管理员或具备特定权限的服务账号，普通用户无法使用
- 依赖前置技能：必须配合
gws-shared完成 OAuth 2.0 授权与全局配置 - 数据延迟：用量报告通常有 24-72 小时延迟，非实时数据
- 速率限制：受 Google API 配额限制，大规模导出需分页处理
适合人群
- Workspace 管理员与 IT 运维团队
- 企业安全合规审计人员
- 需要进行 SaaS 用量分析的成本管理团队
- 开发自动化监控脚本的 DevOps 工程师
常规风险
- 数据敏感：审计日志包含用户行为数据，需严格遵循组织隐私政策与 GDPR 等法规
- 凭证泄露风险：服务账号密钥若保管不当，可能导致全域数据暴露
- 误操作影响：不当的
watch订阅可能产生大量通知，造成日志系统压力
使用建议
始终优先阅读 gws-shared/SKILL.md 完成认证配置，利用 gws schema 探查参数后再构造查询，生产环境建议启用推送通知的日志留存与异常监控。