# Gws Admin Reports

> Google Workspace Admin SDK: Audit logs and usage reports.

Source: https://skillsagentes.com/skills/googleworkspace/cli/gws-admin-reports
Repository: https://github.com/googleworkspace/cli
Author: googleworkspace
License: Apache-2.0
Updated: hace 4 meses
Context cost: 14 tok installed, 589 tok once triggered, 589 tok with every bundled file
Bundle: 1 file, 2 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add googleworkspace/cli --skill gws-admin-reports --agent claude-code
```

## What it does

- Provee acceso CLI a la API Google Workspace Admin SDK Reports (reports_v1)
- Lista actividades de una cuenta de cliente para apps como Admin console o Google Drive
- Obtiene reportes de uso de clientes, entidades y usuarios individuales
- Permite iniciar y detener notificaciones push (watch/stop) sobre canales de actividad

## Use it when

- Necesitas auditar actividad de administración o de Google Drive de una cuenta
- Necesitas estadísticas de uso por cliente, entidad o usuario en Google Workspace

## What triggers it

- "Muéstrame los logs de actividad del admin console del último mes"
- "Obtén el reporte de uso de un usuario específico en Google Workspace"
- "Quiero ver las estadísticas de uso de entidades de la cuenta"

## Before you install

- Requiere el binario `gws` y haber leído ../gws-shared/SKILL.md para autenticación, flags globales y reglas de seguridad.

## Files

- SKILL.md — 2 KB

## SKILL.md

Reproduced verbatim from googleworkspace/cli under Apache-2.0. This section is the upstream document and is in English.

# 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.

```bash
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:

```bash
# 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.

---

Skills Agentes — https://skillsagentes.com/skills/googleworkspace/cli/gws-admin-reports