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 recuperar 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 recurso DriveActivity, que representa los cambios realizados en los objetos dentro del 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 de Drive específico o de todo el contenido de 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 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 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 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 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 tanto para el creador como para los usuarios con los que se compartió.
Si un documento se compartió con un usuario y, luego, se configuró como 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 podrá ver el 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.