A API Google Drive Activity consiste no recurso DriveActivity, que representa as 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 alterações.
Solicitação
Seu app solicita os dados de atividade de um usuário usando o
método activity.query. Você pode solicitar atividade para um item específico do Drive ou para tudo o que está em uma pasta do Drive. Para uma determinada solicitação, é possível optar por restringir a resposta por
restrições, como intervalo de tempo ou tipo de ação, e
optar por consolidar a atividade na
resposta. Saiba mais em Fazer solicitações na API Drive Activity.
Resposta
A resposta a uma solicitação é 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 deles
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 resumidas, como cada
Actor e
Target de todas as ações, um Timestamp
ou TimeRange
unificado e a ActionDetail mais
importante ou representativa
da
Action.
Para mais informações, consulte o modelo de dados da API Drive Activity.
Visibilidade do histórico de atividades
É possível que algumas atividades no Drive não sejam registradas quando você usa esta API. A API Drive Activity informa uma determinada alteração em um objeto se a alteração ou as informações sobre ela estiverem visíveis para o usuário autenticado no aplicativo.
A visibilidade é baseada nas permissões definidas para o objeto. Existem vários cenários quando arquivos e pastas são compartilhados no Drive:
- Se um autor compartilhar um documento, o histórico de atividades dele ficará visível não apenas para o criador, mas também para os usuários autenticados com quem ele foi compartilhado.
- Se um documento tiver sido compartilhado com um usuário e definido como particular, o usuário autenticado poderá ver todo o histórico de atividades enquanto tinha acesso e que as permissões agora estão restritas.
- Se um documento nunca tiver sido compartilhado com um usuário, ele não verá o histórico de atividades.
Começar
Para aproveitar ao máximo a API Drive Activity, primeiro integre seu app à API Google Drive. Para começar a usar a API Drive Activity, saiba como criar um projeto e autorizar solicitações. Outra opção é se aprofundar e ler sobre as atividades na Referência da API.