A API Activity do Google Drive 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 do usuário usando o
método activity.query. Você pode solicitar a atividade de um item específico do Drive ou de todos os itens contidos em uma pasta do Drive. Para determinada solicitação, você pode optar por restringir a resposta por
restrições, como intervalo de tempo ou tipo de ação, e
escolher que a atividade seja consolidada na
resposta. Veja mais informações 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, e cada um é
contido 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 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
Algumas atividades no Drive podem não ser informadas quando você usa esta API. A API Drive Activity informa se uma mudança foi especificada em um objeto e se ela ou não está visível para o usuário autenticado no aplicativo.
A visibilidade é baseada nas permissões definidas para o objeto. Há vários cenários em que os arquivos e as pastas são compartilhados no Drive:
- Se um autor compartilhar um documento, o histórico de atividade do documento 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 foi compartilhado com um usuário e se tornou particular, o usuário autenticado pode ver todo o histórico de atividades enquanto tinha acesso e as permissões estão restritas.
- Se um documento nunca foi compartilhado com um usuário, ele não verá o histórico de atividades.
Para 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. Ou leia mais sobre as atividades na referência da API.