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 mudanças.
Solicitação
Seu app solicita os dados de atividade de um usuário usando o
método activity.query
. É possível solicitar a atividade
para um item específico do Drive ou para tudo 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
também é possível ter a atividade consolidada na
resposta. Para saber mais, consulte 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
independente como um evento. Um Action
inclui
ActionDetail
(como Create
ou Edit
), Actor
(como User
ou Administrator
), Target
(como DriveItem
ou Drive
) e
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 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
É possível que algumas atividades no Drive não sejam registradas quando você usa essa API. Se a API Drive Activity informa uma determinada alteração em um objeto, isso depende se a alteração ou as informações sobre ela estão visíveis para o usuário autenticado no seu aplicativo.
A visibilidade é baseada nas permissões definidas para o objeto. Existem 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 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 poderá ver nenhum histórico de atividades.
Primeiros passos
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, aprenda a criar um projeto e autorizar solicitações. Ou então, vá direto e leia sobre as atividades na Referência da API.