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.