Visão geral da API Reports

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

A API Reports oferece dois tipos de relatórios:

  • Relatórios de atividade, que informam eventos de um aplicativo ou serviço específico, como o Google Drive ou o Admin Console.
  • Relatórios de Uso, que listam os eventos do espaço de trabalho causados pelos usuários.
    • Os relatórios de uso do cliente listam os 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 Reports:

Relatórios de atividades

Os relatórios de atividade listam informações das atividades em um aplicativo ou serviço específico do Google Workspace. 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 dos relatórios de atividade e as informações que eles incluem. Veja alguns exemplos de relatórios de atividade, listados por app ou serviço:

  • Os relatórios de atividade do administrador mostram as atividades realizadas pelos administradores no Admin Console. Por exemplo, é possível ver uma lista de todas as vezes que os administradores alteraram um nome de usuário usando o Admin Console.
  • Os relatórios de atividade do Google Drive listam como os usuários do seu domínio editam e visualizam os documentos do Drive. Por exemplo, você pode acessar uma lista com a atividade de um usuário específico no Drive.
  • Os relatórios de atividade de login fornecem informações sobre quando os usuários da sua conta fazem login e saem das contas. Você pode, por exemplo, conseguir um relatório de todos os logins do seu domínio durante um determinado período.
  • Os relatórios de atividade em dispositivos móveis mostram atividades que usam dispositivos móveis gerenciados pelo Gerenciamento Google de dispositivos móveis. Por exemplo, você pode receber uma notificação quando os usuários registrarem um novo dispositivo.
  • Os relatórios de atividade do token OAuth listam eventos quando seus usuários concederam ou revogaram tokens de autorização usados por sites e aplicativos de terceiros. Use a API Reports para conferir 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 mostram informações sobre os eventos do Google Workspace no seu domínio. É possível usar a API para solicitar informações específicas sobre os usuários.

  • Os relatórios de uso dos clientes listam atividades detalhadas de aplicativos e serviços na sua conta. Essas informações de uso são organizadas por tipo de aplicativo e contêm informações específicas do aplicativo.
  • Os relatórios de uso dos usuários mostram as atividades dos usuários da sua conta. Esses relatórios podem ser personalizados e filtrados para 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 do aplicativo.
  • Os relatórios de uso de entidades listam as atividades relacionadas às entidades usadas pelos usuários da sua conta no aplicativo Currents.
Notificações
A API Reports fornece notificações que permitem acompanhar 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 Como receber notificações push.

Próximas etapas