Introducción a la API de Google Drive Activity

La API de actividad de Google Drive consta del recurso DriveActivity, que representa los cambios realizados en los objetos de Google Drive del usuario, y el método activity.query, que te permite recuperar información sobre esos cambios.

Solicitud

Tu app solicita los datos de actividad del usuario con el método activity.query. Puedes solicitar actividad para un elemento de Drive específico o para todo el contenido de una carpeta de Drive. Para una solicitud determinada, puedes optar por restringir la respuesta mediante restricciones, como un intervalo de tiempo o un tipo de acción, y puedes optar por que la actividad se consolide en la respuesta. Para obtener más información, consulta Cómo realizar solicitudes en la API de actividad de Drive.

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:

Explicación de la actividad de Drive.

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 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 del Action.

Para obtener más información, consulta el modelo de datos de la API de actividad de Drive.

Visibilidad del historial de actividad

Es posible que no se informe cierta actividad en Drive cuando uses esta API. La posibilidad de que la API de Drive Activity informe un cambio determinado a un objeto depende de si el usuario autenticado en tu aplicación puede ver el cambio o la información sobre este.

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 se compartió un documento con un usuario y luego se convirtió en privado, el usuario autenticado podrá ver todo el historial de actividad mientras tenga acceso y que los permisos ahora estén restringidos.
  • Si nunca se compartió un documento con un usuario, este no podrá ver ningún historial de actividad.

Primeros pasos

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 actividad de Drive, obtén información sobre cómo crear un proyecto y autorizar solicitudes. O bien, lee sobre las actividades en la referencia de API.