En este documento, se proporciona una descripción general de la API de Google Drive Activity.
La API de Drive Activity te permite consultar eventos recientes. Puedes obtener un historial detallado de todas las actividades, incluida información detallada sobre cada evento. Esto es útil para tareas como las auditorías, ya que puedes recuperar actividades precisas que incluyen la información de ActionDetail, Actor y Target.
La API de Drive Activity consta del
DriveActivity recurso, que representa
los cambios realizados en los objetos dentro del Google Drive de un usuario, y el
activity.query método, 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 lo que se encuentra en una carpeta de Drive. Para una solicitud determinada, puedes restringir la
respuesta con un filtro, como un período
o un tipo de acción, y puedes consolidar la actividad consolidada en la respuesta. Para obtener más información,
consulta Cómo realizar solicitudes en la API de Google Drive Activity.
Respuesta
La respuesta contiene una lista de actividades que coinciden con los parámetros dados, donde
un DriveActivity recurso representa cada
actividad:
Un recurso DriveActivity es una colección de
Action objetos, 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 un
Timestamp
o TimeRange.
Un recurso DriveActivity también contiene información resumida, como cada
Actor y Target de todas las acciones, un Timestamp o TimeRange unificado,
y el ActionDetail más importante o representativo de la 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 alguna actividad en Drive cuando usas la API de Drive Activity. Si la API informa 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 app.
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 para el creador y los usuarios con los que se compartió.
Si un documento se compartió con un usuario y luego se hizo privado, el usuario puede ver todo el historial de actividad del período en el que tuvo acceso, pero no después de que se restringieron los permisos.
Si un documento nunca se compartió con un usuario, este no puede ver ningún historial de actividad.
Temas relacionados
- Para aprovechar al máximo la API de Drive Activity, primero integra tu app con la API de Google Drive
- Para obtener información sobre el desarrollo con las APIs de Google Workspace, incluida la creación de un proyecto o el manejo de la autenticación y la autorización, consulta Desarrolla en Google Workspace.
- Para obtener información sobre las actividades, consulta la referencia de la API.