skilld
All skills
googleworkspace avatar

/gws-admin-reports

@705fb0e
by Google Workspacegoogleworkspace/cli31k stars
1,856

Google Workspace Admin SDK: Audit logs and usage reports.

Ask your Agent

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

This session only. Nothing lands on disk.

SKILL.md

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

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

Third-party checks

No alerts17d5 checks · Risk SAFE
  • Gen Agent Trust Hub17d

    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.

  • Socket17d

    No alerts

  • Snyk17d

    Risk: LOW · No issues

  • Runlayer6mo

    1 file scanned · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

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

Last checked against GitHub 2 months ago.

Activeupdated 6 months ago

Capability

Other metadata
metadata
{
  "version": "0.22.5",
  "openclaw": {
    "category": "productivity",
    "requires": {
      "bins": [
        "gws"
      ]
    },
    "cliHelp": "gws admin-reports --help"
  }
}

Topics

  • CLI
  • google-workspace
  • admin
  • audit-logs
  • reports
  • gws
  • activity-reports
  • usage-reports

README badge

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

What it does

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.

Frequently asked

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.