Index of every page on this site: llms.txt
All skills
googleworkspace avatar

/gws-admin-reports

@cd3697e
by Google Workspacegoogleworkspace/cli32k stars
1,997
Run it yourself

Google Workspace Admin SDK: Audit logs and usage reports.

Use this Skill: https://skilld.dev/gh/googleworkspace/cli/gws-admin-reports

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈19 tokens for metadata: the name and description. ≈525 when used: this file.

How this Skill uses context

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈77 characters, or 1.0%.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts2mo5 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    This skill provides a legitimate interface for interacting with the Google Workspace Admin SDK using the gws CLI tool to retrieve audit logs and usage reports. No malicious code or unauthorized behaviors were detected.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: LOW · No issues

  • Runlayer8mo

    1 file scanned · No issues

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at cd3697e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 weeks ago.

Activeupdated 8 months ago
Other metadata
metadata
{
  "version": "0.22.5",
  "openclaw": {
    "category": "productivity",
    "requires": {
      "bins": [
        "gws"
      ]
    },
    "cliHelp": "gws admin-reports --help"
  }
}
  • CLI
  • google-workspace
  • admin
  • audit-logs
  • reports
  • gws
  • activity-reports
  • usage-reports

README badge

README badge for googleworkspace/cli/gws-admin-reports

Exposes Google Workspace Admin SDK audit logs and usage reports via CLI, including activities, channels, and per-user or per-entity usage metrics. Use this to query admin console activity, retrieve customer usage data, or set up push notifications for account events.

Generated from the current SKILL.md.

What Google Workspace data does this skill access?
This skill provides access to audit logs via the activities resource and usage reports for customers, entities, and individual users through the Google Workspace Admin SDK reports_v1 API.
Do I need to set up authentication first?
Yes. You must read the gws-shared/SKILL.md skill first to configure auth and understand global flags and security rules.
How do I discover which parameters a report method accepts?
Run `gws schema admin-reports.<resource>.<method>` to inspect required params, types, and defaults for any report method.
Can I set up push notifications for account activities?
Yes. The activities resource includes a watch method to start receiving push notifications for account activities.

Generated from the current SKILL.md. These answers refresh after source changes.