A API Google Drive Activity consiste nos
DriveActivity, que
representa alterações feitas em objetos no Google Drive de um usuário e a
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 atividades
para um item específico do Google Drive ou para todos os itens contidos nele,
do Compute Engine. Para uma determinada solicitação, é possível restringir a resposta
restrições, como período ou tipo de ação, e você
pode optar por consolidar a atividade no
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
O recurso DriveActivity representa cada atividade:
Um recurso DriveActivity é uma coleção de
objetos Action, cada um sendo
independente, como um evento. Um Action inclui um
ActionDetail (como Create
ou Edit), um Actor (como User
ou Administrator), um Target (como
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, uma solução
Timestamp
ou TimeRange, e a maior
importante ou representativo
ActionDetail de
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 informadas quando você usar esta API. Seja A API Drive Activity informa se uma determinada alteração em um objeto depende se a alteração ou as informações sobre ela são visíveis para os usuários usuário em seu aplicativo.
A visibilidade é baseada nas permissões definidas para o objeto. Há várias cenários em que arquivos e pastas são compartilhados no Drive:
- Se um autor compartilhar um documento, o histórico de atividades do documento é 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 documento o usuário pode ver todo o histórico de atividade enquanto tinha acesso e que as permissões agora são restritas.
- Se um documento nunca tiver sido compartilhado com um usuário, ele não poderá ver as atividades história.
Primeiros passos
Para aproveitar ao máximo a API Drive Activity, integre seu app ao API Google Drive primeiro. Para começar a usar a API Drive Activity, aprender a criar um projeto e autorizar solicitações. Ou então comece a ler sobre as atividades no Referência da API.