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 por 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 atividade

Os relatórios de atividade 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 receber uma lista de todas as vezes em que os administradores mudaram o nome de um usuário usando o Admin Console.
  • Os relatórios de atividade do Google Drive mostram como os usuários do seu domínio editam e visualizam os documentos do Drive. Por exemplo, você pode acessar 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 logout das contas. Por exemplo, você pode receber um relatório de todos os logins do seu domínio em um período específico.
  • Os relatórios de atividade em 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 concedem ou revogam tokens de autorização usados por sites e apps de terceiros. Use a API Reports para receber 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 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 cada um deles.
  • 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 cada um deles.
  • 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 fornece notificações que permitem monitorar eventos, como mudanças nos recursos. Quando você está assistindo 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 Recebimento de notificações push.

Próximas etapas