gws-admin-reports▌
googleworkspace/cli · updated Apr 8, 2026
Query Google Workspace audit logs, activity feeds, and usage reports across customers and users.
- ›Access five resource types: activities (with list and watch for push notifications), channels, customer usage reports, entity usage reports, and user usage reports
- ›Retrieve audit logs for specific applications, customer account statistics, and per-user activity and usage metrics
- ›Requires Google Workspace Admin SDK authentication; see shared gws documentation for auth setup and security ru
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
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.
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.5★★★★★44 reviews- ★★★★★Dhruvi Jain· Dec 28, 2024
gws-admin-reports has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Charlotte Patel· Dec 16, 2024
gws-admin-reports has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Dev Huang· Dec 12, 2024
Keeps context tight: gws-admin-reports is the kind of skill you can hand to a new teammate without a long onboarding doc.
- ★★★★★Oshnikdeep· Nov 19, 2024
Solid pick for teams standardizing on skills: gws-admin-reports is focused, and the summary matches what you get after install.
- ★★★★★Charlotte Jackson· Nov 7, 2024
Solid pick for teams standardizing on skills: gws-admin-reports is focused, and the summary matches what you get after install.
- ★★★★★Mia Harris· Nov 3, 2024
We added gws-admin-reports from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Ava Perez· Oct 26, 2024
We added gws-admin-reports from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Diego Choi· Oct 22, 2024
Solid pick for teams standardizing on skills: gws-admin-reports is focused, and the summary matches what you get after install.
- ★★★★★Ganesh Mohane· Oct 10, 2024
We added gws-admin-reports from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Rahul Santra· Sep 21, 2024
Useful defaults in gws-admin-reports — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
showing 1-10 of 44