gws-admin-reports
Ajuda seu agente a obter relatórios de atividades do Google Workspace. Ele coleta dados de auditoria e uso.
O que ela faz
Esta ferramenta ajuda administradores do Google Workspace a obter relatórios sobre atividades e uso dentro da conta da empresa. Ela pode listar atividades específicas ou fornecer resumos de uso por cliente, entidade ou usuário.
Quando usar
- ✓Verificar quem acessou o quê no Google Drive.
- ✓Obter um resumo do uso de aplicativos por todos os usuários.
- ✓Monitorar atividades administrativas na conta.
Exemplo do que pedir para a IA
“Quais foram as atividades de login no Admin Console na última semana?”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
Você informa qual tipo de relatório deseja (atividades, uso por cliente, entidade ou usuário) e a ferramenta consulta os dados do Google Workspace para te mostrar as informações.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add googleworkspace/cli --skill gws-admin-reportsOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/gws-admin-reports/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
admin-reports (reports_v1)
PRÉ-REQUISITO: Leia
../gws-shared/SKILL.mdpara autenticação, flags globais e regras de segurança. Se estiver faltando, executegws generate-skillspara criá-lo.
gws admin-reports <resource> <method> [flags]
Recursos da API
activities
list— Recupera uma lista de atividades para a conta de um cliente específico e aplicativo, como o aplicativo Admin console ou o aplicativo Google Drive. Para mais informações, veja os guias para relatórios de atividade do administrador e do Google Drive. Para mais informações sobre os parâmetros do relatório de atividade, veja os guias de referência de parâmetros de atividade.watch— Começa a receber notificações para atividades da conta. Para mais informações, veja Recebendo Notificações Push.
channels
stop— Para de monitorar recursos através deste canal.
customerUsageReports
get— Recupera um relatório que é uma coleção de propriedades e estatísticas para a conta de um cliente específico. Para mais informações, veja o guia Relatório de Uso de Clientes. Para mais informações sobre os parâmetros do relatório de cliente, veja os guias de referência de parâmetros de Uso de Clientes.
entityUsageReports
get— Recupera um relatório que é uma coleção de propriedades e estatísticas para entidades usadas por usuários dentro da conta. Para mais informações, veja o guia Relatório de Uso de Entidades. Para mais informações sobre os parâmetros do relatório de entidades, veja os guias de referência de parâmetros de Uso de Entidades.
userUsageReport
get— Recupera um relatório que é uma coleção de propriedades e estatísticas para um conjunto de usuários da conta. Para mais informações, veja o guia Relatório de Uso de Usuários. Para mais informações sobre os parâmetros do relatório de usuário, veja os guias de referência de parâmetros de Uso de Usuários.
Descobrindo Comandos
Antes de chamar qualquer método da API, inspecione-o:
# Browse resources and methods
gws admin-reports --help
# Inspect a method's required params, types, and defaults
gws schema admin-reports.<resource>.<method>
Use a saída de gws schema para construir suas flags --params e --json.
Perguntas frequentes
Como sei quais relatórios estão disponíveis?
Você pode usar o comando '--help' para ver todas as opções de relatórios e atividades que a ferramenta pode buscar.
Preciso de alguma permissão especial?
Sim, você precisa ter permissões de administrador no Google Workspace para usar esta ferramenta.
Posso receber notificações sobre novas atividades?
Sim, a ferramenta permite configurar notificações para ser avisado quando certas atividades acontecerem.
Detalhes
Descrição original do autor
Google Workspace Admin SDK: Audit logs and usage reports.
repo: googleworkspace/cli
Popularidade
- Estrelas no GitHub
- 32 mil
- Posição no ranking
- #6250
- Licença
- Apache-2.0
- Atualizada em
- 06/10/2026
Comentários
- …
Mais skills deste repositório
gws-calendar-agenda
Ajuda seu agente a ver eventos futuros em todos os calendários. É útil para organizar sua agenda e saber o que está por vir.
googleworkspace/cli
gws-calendar-insert
Faz seu agente criar novos eventos no Google Agenda. É útil para agendar compromissos e reuniões.
googleworkspace/cli
gws-calendar
Permite que seu agente gerencie calendários e eventos. É útil para organizar sua vida e trabalho.
googleworkspace/cli
gws-chat-send
Ajuda seu agente a enviar mensagens para um espaço no Google Chat. É útil para se comunicar com equipes.
googleworkspace/cli
Skills parecidas
data-throughput-accelerator
Faz seu agente acelerar a movimentação de grandes volumes de dados. Ele encontra gargalos e garante que os dados sejam transferidos de forma rápida e correta.
affaan-m/ECC
inventory-demand-planning
Ajuda seu agente a prever a demanda de produtos em lojas. Ele otimiza o estoque e planeja quando fazer promoções para vender mais.
affaan-m/ECC
market-research
Ajuda seu agente a realizar pesquisas de mercado e análises competitivas. Fornece resumos com atribuição de fontes.
affaan-m/ECC