Este documento apresenta uma visão geral da API Google Drive Activity.
A API Drive Activity permite consultar eventos recentes. Você pode buscar um histórico detalhado de todas as atividades, incluindo informações granulares sobre cada evento. Isso é útil para tarefas como auditorias, já que é possível recuperar atividades precisas que incluem as informações ActionDetail, Actor e Target.
A API Drive Activity consiste no recurso
DriveActivity, que representa
mudanças feitas em objetos no Google Drive de um usuário, e no método
activity.query, que permite recuperar
informações sobre essas mudanças.
Solicitação
O app solicita os dados de atividade de um usuário usando o método activity.query. Você pode solicitar a atividade de um item específico do Drive ou de tudo o que está em uma pasta do Drive. Para uma determinada solicitação, é possível restringir a resposta usando um filtro, como período ou tipo de ação, e consolidar a atividade na resposta. Para mais informações,
consulte Fazer solicitações na API Google Drive Activity.
Resposta
A resposta contém uma lista de atividades que correspondem aos parâmetros fornecidos, em que
um recurso DriveActivity representa cada
atividade:
Um recurso DriveActivity é uma coleção de objetos Action, cada um independente como um evento. Um Action inclui um ActionDetail (como Create ou Edit), um Actor (como User ou Administrator), um Target (como DriveItem ou Drive) e um
Timestamp
ou TimeRange.
Um recurso DriveActivity também contém informações de resumo, como todos os Actor e Target de todas as ações, um Timestamp ou TimeRange unificado e o ActionDetail mais importante ou representativo do Action.
Para mais informações, consulte o modelo de dados da API Drive Activity.
Visibilidade do histórico de atividades
Algumas atividades no Drive podem não ser informadas quando você usa a API Drive Activity. Se a API informa uma determinada mudança em um objeto, isso depende de se a mudança ou as informações sobre ela estão visíveis para o usuário autenticado no seu app.
A visibilidade é baseada nas permissões definidas para o objeto. Há vários cenários em que arquivos e pastas são compartilhados no Drive:
Se um autor compartilhar um documento, o histórico de atividades dele vai ficar visível para o criador e para os usuários com quem ele foi compartilhado.
Se um documento foi compartilhado com um usuário e depois se tornou particular, ele poderá ver todo o histórico de atividades do período em que teve acesso, mas não depois que as permissões foram restritas.
Se um documento nunca foi compartilhado com um usuário, ele não poderá ver o histórico de atividades.
Temas relacionados
- Para aproveitar ao máximo a API Drive Activity, primeiro integre seu app à API Google Drive.
- Para saber mais sobre o desenvolvimento com as APIs do Google Workspace, incluindo a criação de um projeto ou o processamento de autenticação e autorização, consulte Desenvolver no Google Workspace.
- Para saber mais sobre atividades, consulte a referência da API.