La API de actividad de Google Drive consta del recurso DriveActivity
, que representa los cambios realizados en los objetos en la unidad de Google Drive de un usuario, y el método activity.query
, que te permite recuperar información sobre esos cambios.
Solicitud
Tu app solicita los datos de actividad de un usuario usando el método activity.query
. Puedes solicitar actividad para un elemento específico de Drive o para todo el contenido de una carpeta de Drive. Para una solicitud determinada, puedes optar por restringir la respuesta por restricciones, como el intervalo de tiempo o el tipo de acción, y puedes elegir que la actividad se consolide en la respuesta. Si deseas 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 la que un recurso DriveActivity
representa cada actividad:
Un recurso DriveActivity
es una colección de objetos Action
, cada uno de los cuales es independiente como un evento. Un Action
incluye un ActionDetail
(como Create
o Edit
), un Actor
(como User
o Administrator
), un Target
(como DriveItem
o Drive
) y Timestamp
o TimeRange
.
Un recurso DriveActivity
también contiene información de resumen, como cada Actor
y Target
de todas las acciones, un Timestamp
o TimeRange
unificado y el ActionDetail
más importante o representativo de Action
.
Si deseas 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. Que la API de Drive Activity informe un cambio determinado en un objeto depende de si el cambio o la información sobre el cambio son visibles para el usuario autenticado en tu aplicación.
La visibilidad se basa en los permisos configurados para el objeto. Existen varias situaciones en las que los archivos y las carpetas se comparten en Drive:
- Si un autor comparte un documento, el historial de actividad del documento será visible no solo para el creador, sino también para los usuarios autenticados con los que se compartió.
- Si un documento se compartió con un usuario y luego se hizo privado, el usuario autenticado podrá ver todo el historial de actividad mientras tenía acceso y los permisos ahora están restringidos.
- Si nunca se compartió un documento con un usuario, este no podrá ver ningún historial de actividad.
Comenzar
Para aprovechar al máximo la API de Drive Activity, primero integra tu app con la API de Google Drive. Para comenzar a usar la API de Drive Activity, obtén información sobre cómo crear un proyecto y autorizar solicitudes. O bien, puedes obtener más información sobre las actividades en la referencia de la API.