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:
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.