Introducción a la API de actividad de Google Drive

La API de Google Drive Activity consta de las DriveActivity, que representa los cambios realizados en los objetos de la cuenta de Google Drive de un usuario activity.query, que te permite recuperar información sobre esos cambios.

Solicitud

Tu app solicita los datos de actividad de un usuario mediante el activity.query. Puedes solicitar la actividad ya sea para un elemento específico de Drive o para todo el contenido de una unidad de Drive carpeta. Para una solicitud determinada, puedes optar por restringir la respuesta restricciones, como el intervalo de tiempo o el tipo de acción, y puedes elegir que la actividad se consolide en la respuesta. Para obtener más información, consulta Cómo realizar solicitudes en la API de Drive Activity.

Respuesta

La respuesta a una solicitud es una lista de actividades que coinciden con los parámetros dados. en el que un El recurso DriveActivity representa cada actividad:

Explicación de la actividad de Drive.

Un recurso DriveActivity es una colección de Action, cada uno de los cuales es autónomo, como un evento. Un elemento Action incluye un ActionDetail (como Create o Edit), un Actor (como User o Administrator), un Target (como DriveItem o Drive), y un Timestamp o TimeRange.

Un recurso DriveActivity también contiene información resumida, como cada Actor y Target de todas las acciones, un espacio Timestamp o TimeRange, y el nombre importante o representativa ActionDetail de las Action

Para obtener más información, consulta el modelo de datos de la API de Drive Activity.

Visibilidad del historial de actividad

Es posible que no se informe cierta actividad en Drive cuando uses esta API. Ya sea que el campo La API de Drive Activity informa que un cambio determinado se realiza en un objeto depende de si el cambio, o la información sobre el cambio, es visible para el usuario en tu aplicación.

La visibilidad se basa en los permisos establecidos para el objeto. Existen varias situaciones en las que se comparten archivos y carpetas en Drive:

  • Si un autor comparte un documento, se muestra su historial de actividad. es visible no solo para el creador, sino también para los usuarios autenticados con quién se compartió.
  • Si un documento se compartió con un usuario y luego se convirtió en privado, el usuario usuario puede ver todo el historial de actividad mientras tuvo acceso y que los permisos ahora están restringido.
  • Si nunca se compartió un documento con un usuario, este no podrá ver ninguna actividad. de Google Chat.

Comenzar

Para aprovechar al máximo la API de Drive Activity, integra tu aplicación con el API de Google Drive primero. Para comenzar a usar la API de Drive Activity, aprenderás a crear un proyecto y autorizar solicitudes. O sumérgete y lee sobre las actividades en la Referencia de la API.