Visão geral da API Reports

A API Reports é uma API RESTful que você pode usar para acessar informações sobre os as atividades do Google Workspace dos seus usuários. A API Reports faz parte da API SDK Admin.

Na API Reports, há dois tipos de relatórios:

  • Relatórios de atividades, que informam eventos de um aplicativo específico ou como o Google Drive ou o Admin Console.
  • Relatórios de uso, que listam eventos do espaço de trabalho causados pelos usuários.
    • Os relatórios de uso de clientes listam eventos de todos os usuários no seu domínio.
    • Os relatórios de uso do usuário listam os eventos organizados por usuário.

Veja a seguir uma lista de termos comuns usados na API de relatórios:

Relatórios de atividades

Os relatórios de atividades listam informações de atividades em um Google Workspace específico aplicativo ou serviço. Os relatórios de atividade incluem a data, a hora, o usuário e o tipo de atividade. A Referência da API contém uma lista completa de relatórios de atividade e as informações que incluem. Veja alguns exemplos de relatórios de atividade, listados por aplicativo ou serviço:

  • Relatórios de atividade do administrador mostrar as atividades feitas pelos administradores usando o Admin Console. Por exemplo: pode acessar uma lista de todas as vezes que os administradores alteraram o nome de um usuário no Admin Console.
  • Relatórios de atividade do Google Drive liste como os usuários do domínio editam e visualizam os documentos do Google Drive. Para Por exemplo, é possível ver uma lista da atividade de um usuário específico no Google Drive.
  • Relatórios de atividade de login fornecer informações sobre quando os usuários da sua conta fazem login e saem dos contas de serviço. Você pode, por exemplo, obter um relatório de todos os logins de sua domínio em um determinado período.
  • Relatórios de atividade em dispositivos móveis mostrar atividades usando dispositivos móveis gerenciados por Gerenciamento Google de dispositivos móveis. Por exemplo, é possível receber uma notificação quando os usuários registrarem um novo dispositivo.
  • Relatórios de atividade do token OAuth Listar eventos quando seus usuários concederem ou revogarem tokens de autorização por sites e aplicativos de terceiros. Use a API Reports para uma lista de todos os acessos de terceiros aos dados do Google Workspace de um usuário.
Relatórios de uso

Os relatórios de uso fornecem informações sobre os eventos do Google Workspace no seu domínio. Você pode usar a API para solicitar informações específicas sobre os usuários.

  • Relatórios de uso dos clientes listar atividades detalhadas de aplicativos e serviços na sua conta. Este uso informações são organizadas por tipo de aplicativo e contêm informações específicas desse aplicativo.
  • Relatórios de uso dos usuários mostrar as atividades dos usuários da sua conta. Esses relatórios podem ser personalizados e filtrada por informações de uso específicas. Essas informações de uso são organizadas por tipo de aplicativo e contém informações específicas desse aplicativo.
  • Relatórios de uso de entidades lista as atividades relacionadas a entidades usadas pelos usuários da sua conta no aplicativo Currents.
Notificações
A API Reports fornece notificações que permitem observar eventos, como mudanças nos recursos. Quando você está monitorando um recurso e ele muda, a API Reports envia uma notificação. Para mais informações sobre como configurar e receber notificações da API Reports, consulte o guia para Como receber notificações push.

Próximas etapas