AutoGineer
Generated banner for Gws Admin Reports
Generated logo for Gws Admin Reports

Gws Admin Reports

Google WorkspaceOfficialPublished by Google Workspace

  • Skill
  • Tool integration
  • Automation and integrations
  • Apache-2.0
  • No issues found
Download ZIP

From the author

Google Workspace Admin SDK: Audit logs and usage reports.
— the description by Google Workspace

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The gws-admin-reports skill provides a command-line interface to interact with the Google Workspace Admin SDK. It enables administrators to retrieve audit logs, monitor account activities, and generate usage reports for customers, entities, and individual users within a Google Workspace environment.

What it does

  • Retrieves audit logs for specific Google Workspace applications.
  • Fetches customer-level usage reports and statistics.
  • Generates reports on entity usage within the account.
  • Provides access to user-specific usage statistics.
  • Supports push notification management for account activities.
  • Allows inspection of API schemas, parameters, and methods.

When to use it

  • When you need to audit administrative or application-level activities.
  • When generating usage statistics for your Google Workspace account.
  • When monitoring specific user activity patterns.
  • When setting up or managing push notifications for account events.

Advantages

  • Direct command-line access to Google Workspace reporting data.
  • Granular control over report parameters via schema inspection.
  • Supports both activity monitoring and usage reporting in one tool.

Usage examples

“List recent activities for the Google Drive application.”
The agent executes the activities list method to retrieve a log of Drive-related events.
“Get usage statistics for a specific user.”
The agent uses the userUsageReport get method to fetch the requested user metrics.

Install

  1. Download the skill as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/googleworkspace/gws-admin-reports/download

  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip gws-admin-reports.zip -d .agents/skills

Documentation by Google Workspace

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.

Files

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by
Google Workspace
Publisher
Google Workspace (Official)
Source
googleworkspace/cli · skills/gws-admin-reports · commit cd3697e
Licence
Apache License 2.0 (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Google Workspace.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download gws-admin-reports.zip