跳到主要内容
哒哒星球DADA PLANET

Skill · 已公开版本

gws-admin-reports · 核对组织操作记录与使用情况

通过 Workspace 报告入口读取指定时间和应用的数据，把操作事件与汇总用量分开整理。

kiko · 平台官方 · 主要由 AI 生成

查看安装步骤 再找一个方法

先看看示例

作者提供的示例，实际效果取决于你的输入和使用工具。

输入

编辑材料：仅有2026-09-01的两条虚构活动：09:10用户u1执行文件共享，09:30用户u2取消文件共享；未提供组织人数、访问权限变化详情或用量报表。

输出

编辑示例 · 未运行
当天这份材料包含2条共享相关活动，涉及u1和u2各1条。u1的共享对象与权限级别尚不明确，不能据此判断是否外部共享；u2的取消动作也不能证明所有访问权限已清除。

缺少组织用户总数及统一用量口径，因此本材料不能计算活跃率。若要核对外部访问，应补读事件参数和对应权限证据。

方法说明

---
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.

```bash
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:

```bash
# 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.