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
O app solicita os dados de atividade de um usuário usando o
método activity.query. É possível solicitar a atividade
de um item específico do Drive ou de tudo o que está contido em uma pasta
do Drive. Para uma determinada solicitação, você pode restringir a resposta por
restrições, como período ou tipo de ação, e
pode escolher que a atividade seja consolidada na
resposta. Para mais informações, 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 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 todos os
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 essa API. A API Drive Activity vai informar uma determinada mudança em um objeto se a mudança ou as informações sobre ela estiverem visíveis para o usuário autenticado no app.
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 atividades dele fica 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 depois tornou-se privado, o usuário autenticado pode conferir todo o histórico de atividades enquanto tinha acesso e que as permissões agora estão restringidas.
- Se um documento nunca foi compartilhado com um usuário, ele não poderá acessar o histórico de atividades.
Primeiros passos
Para aproveitar ao máximo a API Drive Activity, 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 mergulhe de cabeça e leia sobre atividades na referência da API.