SuperAPI AI 工具集

gws-admin-reports

通用与其它

查看项目

更新于 10-16 09:37

技能介绍

用途

gws-admin-reports 用于通过命令行访问 Google Workspace Admin SDK 的 reports_v1 API,主要面向审计日志与使用情况报告。它是 googleworkspacecli 技能集的一部分,命令形式为:

gws admin-reports <resource> <method> [flags]

主要能力(API 资源与方法)

activities

  • list — 获取特定客户账户与应用(例如 Admin console 应用或 Google Drive 应用)的活动列表。
  • watch — 开始接收账户活动的通知。

channels

  • stop — 停止通过该频道监听资源。

customerUsageReports

  • get — 获取针对特定客户账户的属性与统计信息集合报告。

entityUsageReports

  • get — 获取账户内用户所用实体的属性与统计信息集合报告。

userUsageReport

  • get — 获取账户内一组用户的属性与统计信息集合报告。

使用方式

前置条件:阅读 ../gws-shared/SKILL.md 以了解认证、全局参数和安全规则;若该文件缺失,运行 gws generate-skills 生成。

调用任何 API 方法前,可先检查:

浏览资源与方法

gws admin-reports --help

查看某方法所需的参数、类型与默认值

gws schema admin-reports.<resource>.<method>

使用 gws schema 的输出构建 --params 与 --json 参数。

适用场景

  • 管理员查询 Admin console、Google Drive 等应用的账户活动记录。
  • 以推送通知方式持续接收账户活动。
  • 获取客户级、实体级或用户级的使用情况统计报告。
  • 在需要以命令行方式访问 Workspace 审计与用量数据时使用。

限制

  • 需先完成认证配置(见 gws-shared),本资料未提供具体认证步骤与凭据细节。
  • 各方法的具体必填参数、类型与默认值需通过 gws schema 查询,本资料未逐一列出。
  • 关于推送通知的配置细节、报告返回的具体字段与统计口径,资料中未提供。
  • 未提供收费、价格、平台或效果相关信息。