gws-admin-reports 是 Google Workspace Admin SDK 报告接口(reports_v1)的命令行技能,主要用于获取管理审计日志与使用情况统计数据。
使用前提:需要先阅读 ../gws-shared/SKILL.md,了解认证方式、全局参数和安全规则;如果该文件缺失,可运行 gws generate-skills 生成。
调用形式为:gws admin-reports <resource> <method> [flags]。
主要能力按资源划分如下:
activities(活动报告):
- list:获取特定客户账号和应用程序的活动列表,例如管理控制台应用或 Google Drive 应用的活动记录,可用于管理员活动报告和 Google Drive 活动报告。
- watch:开始接收账号活动通知,对应推送通知的接收方式。
channels(通知通道):
- stop:停止通过该通道对资源进行监听。
customerUsageReports(客户使用报告):
- get:获取包含特定客户账号属性与统计信息的报告,对应客户使用情况报告。
entityUsageReports(实体使用报告):
- get:获取账号内用户所用实体的属性与统计信息报告,对应实体使用情况报告。
userUsageReport(用户使用报告):
- get:获取账号中一组用户的属性与统计信息报告,对应用户使用情况报告。
使用方式:在调用任何 API 方法之前,建议先查看其定义。可使用 gws admin-reports --help 浏览资源和方法的层级结构;使用 gws schema admin-reports.<resource>.<method> 查看某个方法所需的参数、类型和默认值。然后根据 gws schema 的输出,构建 --params 和 --json 参数来发起调用。
适用场景:需要以程序化方式审计 Google Workspace 账号活动、接收活动推送通知,或拉取客户、实体、用户级别的使用统计时。
限制:当前资料未提供具体认证配置细节、返回字段、配额限制、是否收费等信息,暂未提供。