Technical & DevelopmentIntermediate
gws-admin-reports
Audit logs and usage reports for Workspace
Developer Setup
Setup & Installation
bash
npx skills add https://github.com/googleworkspace/cli --skill gws-admin-reportsnpx skills add https://github.com/googleworkspace/cli --skill gws-admin-reportsOr paste this URL into your assistant to install:
Overview
What This Skill Does
Wraps the Google Workspace Admin SDK Reports API to pull audit logs and usage statistics from a command line. Covers activity logs for apps like Drive and Admin console, plus per-user and customer-wide usage reports. Also supports push notification channels for real-time activity streaming.
Application
When to use this Skill
- Configuring integration settings for custom agent workflows.
- Optimizing query execution and response latency in production.
- Developing clean, standard-compliant implementations for enterprise services.
- Troubleshooting connection timeouts and authentication handshakes.
- Monitoring API rate limits and execution pipelines programmatically.
Documentation
Show Skills.md file
admin-reports (reports_v1)
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto 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
Lines 1 - 25 of 44
Recommendations