360 Secure SkillHub
360 安全技能中心

Gws Admin Reports

该工具基于Google Workspace Admin SDK的reports_v1接口,通过CLI提供核心功能:可查询账户活动审计日志,获取客户、实体、用户多维度的使用统计报表,还能启动或停止活动通知推送。典型场景包括管理员排查操作记录、统计团队服务使用情况、监控关键活动并接收告警。需依赖gws工具,输入为带参数的CLI命令,输出结构化报表或操作结果。

googleworkspace-bot
googleworkspace-bot
热度 76.07
最近更新 2026-05-11 17:28:41
分类:数据依赖:第三方 API应用场景:报告撰写 / 数据处理

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add gws-admin-reports
Metadata
name
gws-admin-reports
description
Google Workspace Admin SDK: Audit logs and usage reports.
metadata
{"version":"0.22.5","openclaw":{"category":"productivity","requires":{"bins":["gws"]},"cliHelp":"gws admin-reports --help"}}

admin-reports (reports_v1)

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

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

API Resources

activities

  • list — Retrieves a list of activities for a specific customer's account and application such as the Admin console application or the Google Drive application. For more information, see the guides for administrator and Google Drive activity reports. For more information about the activity report's parameters, see the activity parameters reference guides.
  • watch — Start receiving notifications for account activities. For more information, see Receiving Push Notifications.

channels

  • stop — Stop watching resources through this channel.

customerUsageReports

  • get — Retrieves a report which is a collection of properties and statistics for a specific customer's account. For more information, see the Customers Usage Report guide. For more information about the customer report's parameters, see the Customers Usage parameters reference guides.

entityUsageReports

  • get — Retrieves a report which is a collection of properties and statistics for entities used by users within the account. For more information, see the Entities Usage Report guide. For more information about the entities report's parameters, see the Entities Usage parameters reference guides.

userUsageReport

  • get — Retrieves a report which is a collection of properties and statistics for a set of users with the account. For more information, see the User Usage Report guide. For more information about the user report's parameters, see the Users Usage parameters reference guides.

Discovering Commands

Before calling any API method, inspect it:

# Browse resources and methods
gws admin-reports --help

# Inspect a method's required params, types, and defaults
gws schema admin-reports.<resource>.<method>

Use gws schema output to build your --params and --json flags.