Introdução à API Google Drive Activity

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:

Explicação sobre a atividade no Drive.

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.