PluginBench
Skill
Pass
Audit score 90

gws-admin-reports

googleworkspace/cli

Query Google Workspace audit logs and usage reports via Admin SDK.

What is gws-admin-reports?

Access Google Workspace Admin SDK to retrieve audit logs, activity reports, and usage statistics for your organization. Use this to monitor account activities, track resource consumption, and generate compliance reports.

  • Retrieve activity logs for specific applications and customers
  • Monitor account activities with push notifications via watch channels
  • Get customer-wide usage reports and statistics
  • Access entity usage reports for resources used within your account
  • Generate user usage reports for sets of users

How to install gws-admin-reports

npx skills add null --skill gws-admin-reports
Prerequisites
  • gws CLI tool installed
  • Google Workspace Admin SDK credentials configured (see gws-shared/SKILL.md)
  • Appropriate admin permissions in Google Workspace
Claude Code
Cursor
Windsurf
Cline

How to use gws-admin-reports

  1. 1.Run `gws admin-reports --help` to browse available resources and methods
  2. 2.Use `gws schema admin-reports.<resource>.<method>` to inspect required parameters and types
  3. 3.Build your command with `gws admin-reports <resource> <method>` plus `--params` or `--json` flags
  4. 4.Execute the command to retrieve logs or reports

Use cases

Good for
  • Audit admin console and Google Drive activities for compliance
  • Track resource consumption across your organization
  • Monitor user activity patterns and usage trends
  • Set up real-time notifications for account activities
  • Generate usage reports for billing or capacity planning
Who it's for
  • Google Workspace administrators
  • Compliance and audit teams
  • IT operations and monitoring teams
  • Organization managers tracking resource usage

gws-admin-reports FAQ

What authentication is required?

See the gws-shared/SKILL.md file for auth setup and security rules. You need Google Workspace Admin SDK credentials configured.

How do I discover what parameters a method accepts?

Run `gws schema admin-reports.<resource>.<method>` to see required params, types, and defaults for any API method.

Can I receive real-time notifications?

Yes, use the `activities watch` method to start receiving push notifications for account activities.

What types of reports can I generate?

You can retrieve customer usage reports, entity usage reports, and user usage reports with various parameters for filtering and analysis.

Full instructions (SKILL.md)

Source of truth, from googleworkspace/cli.


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.