La API de Google Drive Activity consta del recurso DriveActivity, que representa los cambios realizados en los objetos dentro de 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 con el método activity.query. Puedes solicitar la actividad de un elemento específico de Drive o de todo el contenido de una carpeta de Drive. Para una solicitud determinada, puedes restringir la respuesta según restricciones, como el período 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 proporcionados, 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 autónomo como un evento. Un objeto Action incluye un ActionDetail (como Create o Edit), un Actor (como User o Administrator), un Target (como DriveItem o Drive) y un Timestamp o un 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 del 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 parte de la actividad en Drive cuando uses esta API. Si la API de Drive Activity informa un cambio determinado en un objeto depende de si el cambio, o la información sobre el cambio, es visible para el usuario autenticado 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, el historial de actividad del documento es 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 configuró como privado, el usuario autenticado puede ver todo el historial de actividad mientras tuvo acceso y que los permisos ahora están restringidos.
- Si un documento nunca se compartió con un usuario, este no podrá ver el 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. También puedes leer sobre las actividades en la referencia de la API.