Visão geral da API Reports

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

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 eventos do espaço de trabalho causados pelos usuários.
    • Os relatórios de uso do cliente listam eventos de todos os usuários no seu domínio.
    • Os relatórios de uso do usuário listam eventos organizados por usuário.

Confira a seguir uma lista de termos comuns usados na API Reports:

Relatórios de atividades

Os relatórios de atividades listam informações sobre 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 de relatórios de atividade e as informações que eles incluem. Confira alguns exemplos de relatórios de atividade, listados por aplicativo ou serviço:

  • Os relatórios de atividade do administrador mostram as atividades realizadas pelos administradores usando o Admin Console. Por exemplo, você pode conferir uma lista de todas as vezes que os administradores mudaram o nome de um 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 acessam os documentos do Drive. Por exemplo, você pode receber uma lista da 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 dela. Por exemplo, é possível gerar um relatório de todos os logins do seu domínio em um período específico.
  • Os relatórios de atividade de dispositivos móveis mostram atividades usando dispositivos móveis gerenciados pelo Gerenciamento de dispositivos móveis do Google. 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 os usuários concederam ou revogaram tokens de autorização usados por sites e aplicativos de terceiros. Você pode usar 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 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.

  • 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 para esse 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 por informações de uso específico. Essas informações de uso são organizadas por tipo de aplicativo e contêm informações específicas para esse aplicativo.
  • Os relatórios de uso de entidades listam atividades relacionadas a entidades usadas pelos usuários da sua conta no aplicativo Currents.
Notificações
A API Reports oferece notificações que permitem monitorar eventos, como mudanças nos recursos. Quando você monitora 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 sobre Como receber notificações push.

Próximas etapas