Relatórios de uso e auditoria do Google Workspace

O que esta skill faz

Esta skill apresenta a interface gws para os recursos de relatórios do Google Workspace Admin SDK. Ela permite consultar atividades e uso de clientes, entidades e usuários, além de gerenciar notificações.

Quando usar

• Consultar atividades administrativas ou do Google Drive
• Obter estatísticas de uso da organização
• Analisar uso por usuário ou entidade
• Iniciar e encerrar notificações de atividades

Como usar

1. Leia as instruções compartilhadas de autenticação e segurança
2. Confirme o acesso com gws e consulte gws admin-reports --help
3. Escolha o recurso e o método adequados
4. Informe os parâmetros exigidos pela consulta
5. Revise o escopo e os dados retornados

O que revisar antes de instalar

• O acesso depende das permissões configuradas no Google Workspace
• Os parâmetros variam conforme o tipo de relatório
• A skill não interpreta nem audita automaticamente os resultados

SKILL.md

---
name: gws-admin-reports
description: "Google Workspace Admin SDK: Audit logs and usage reports."
metadata:
  version: 0.22.5
  openclaw:
    category: "productivity"
    requires:
      bins:
        - gws
    cliHelp: "gws admin-reports --help"
---

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