gws-admin-reports

Retrieves Google Workspace Admin SDK audit logs and usage reports for account monitoring.

30.3k|1.8k|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/googleworkspace/cli --skill gws-admin-reports-googleworkspace
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-admin-reports
Source: https://github.com/googleworkspace/cli/tree/main/skills/gws-admin-reports
Command: npx skills add https://github.com/googleworkspace/cli --skill gws-admin-reports-googleworkspace

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides access to Google Workspace Admin SDK audit logs and usage reports, enabling administrators to monitor account activity and user behavior.

Core Features & Use Cases

  • Audit Log Access: Retrieve detailed activity logs for various Google Workspace applications.
  • Usage Reporting: Generate reports on customer and entity usage within the Workspace environment.
  • Real-time Notifications: Set up watch channels to receive push notifications for account activities.
  • Use Case: An administrator can use this Skill to investigate suspicious login activity by listing user activities for the Admin console application.

Quick Start

List all activities for the Admin console application for your customer account.

Frequently Asked Questions about gws-admin-reports

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I access Google Workspace audit logs for account monitoring?

You can access Google Workspace audit logs by retrieving detailed activity logs for various applications using the Admin SDK. This enables administrators to monitor account activity and investigate user behavior directly.

Can I generate usage reports for users and entities in Google Workspace?

Yes, you can generate usage reports by retrieving customer and entity usage data within the Workspace environment. This provides administrators with insights into how resources are being consumed across the domain.

How do I set up real-time notifications for Google Workspace account activities?

You can set up real-time notifications by managing watch channels to receive push notifications for account activities. This allows administrators to monitor suspicious behavior as it happens.

Do I need special authentication to retrieve Google Workspace Admin SDK reports?

Yes, retrieving Admin SDK reports requires authentication with the Google Workspace Admin SDK. Administrators must also ensure they adhere to API rate limits when querying usage or activity data.

What is the best way to investigate suspicious login activity in the Google Workspace Admin console?

The best way to investigate suspicious login activity is by listing user activities specifically for the Admin console application. This retrieves detailed audit logs to help identify anomalous account access patterns.

Are there API rate limits when accessing Google Workspace usage reports?

Yes, you must adhere to API rate limits when accessing Google Workspace usage reports. The Skill enforces these limits during authentication with the Admin SDK to retrieve customer and entity usage data.