Introdução à API Google Drive Activity

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:

Explicação sobre a atividade no Drive.

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.