El informe Actividad de Drive proporciona información sobre las actividades de los usuarios cuando administran, modifican y comparten archivos en Google Drive en Google Workspace. Por ejemplo, puedes usar el informe de actividad de Drive para obtener una lista de todos los documentos nuevos de Drive que creó un usuario específico durante un rango de fechas específico. Puedes usar esta información para obtener estadísticas sobre una mejor administración de contenido y posibles filtraciones de datos. Para obtener un informe, usa la solicitud básica de extremo de informe con parámetros específicos del informe, como la dirección de correo electrónico de un usuario o un tipo específico de cambio en Google Drive. Los informes pueden incluir datos de hasta los últimos 180 días.
El informe de actividad de Google Drive solo se puede utilizar para fines legales en las cuentas que tienen una licencia asignada.
Si deseas obtener información acerca de las cadenas de consulta de la solicitud y las propiedades de la respuesta, consulta la Referencia de la API. Para obtener información sobre eventos específicos relacionados con Google Drive, consulta Nombres de eventos de Drive.
Recuperar eventos de Google Drive de un dominio
Puedes usar el informe de actividad de Drive para mostrar la información sobre tus documentos de Drive. Por ejemplo, puedes solicitar un informe que enumere los 25 eventos de Drive más recientes de tu cuenta, que abarquen hasta 180 días. Para obtener este informe, obtén un token de autorización como se describe en la guía de autorización y, luego, usa la siguiente solicitud HTTP GET
:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25
Puedes ver una respuesta de ejemplo a esta llamada a la API.
En el siguiente ejemplo, se recupera un informe de todos los eventos de Drive de los últimos 180 días, que es el período máximo.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive
Recupera eventos de Google Drive por usuario
Para recuperar un informe de las actividades en Google Drive de un usuario específico, usa una solicitud HTTP GET
con el token de autorización descrito en la guía de la guía de autorización.
El campo userKey
es la dirección de correo electrónico principal del usuario en el informe o all
para todos los usuarios.
En el siguiente ejemplo, se recupera un informe que enumera todos los cambios que realizó el usuario especificado. Para ver un ejemplo de una respuesta de la API, consulta la respuesta JSON de muestra.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/kim@example.com
/applications/drive
Recuperar eventos de Google Drive de las unidades compartidas
Puedes recuperar un informe de actividades de Google Drive de una unidad compartida específica mediante una solicitud GET
HTTP con el token de autorización descrito en la guía de autorización. Especifica la dirección de correo electrónico del usuario sobre el que deseas ejecutar el informe en el campo userKey
o especifica all
para ejecutar el informe sobre todos los usuarios.
En el siguiente ejemplo, se recupera un informe de todos los cambios de una unidad compartida específica. Para ver un ejemplo de una respuesta de la API, consulta la respuesta JSON de muestra.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=shared_drive_id==<id of shared drive>
Para recuperar eventos de una unidad compartida, filtra usando el doc_type
. En el siguiente ejemplo, se recuperan los eventos que afectan a todas las unidades compartidas:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=doc_type=shared_drive
Para recuperar eventos relacionados con los cambios de membresía, especifica el evento shared_drive_membership_change
. En el siguiente ejemplo, se recuperan todas las incorporaciones de miembros a las unidades compartidas:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?evetName=shared_drive_membership_change&
filters=membership_change_type==add_to_shared_drive
Recupera eventos de Google Drive por tipo de evento
Para recuperar un informe de todas las instancias de un tipo de evento específico, como la creación o edición de un documento, usa una solicitud GET
HTTP con el token de autorización que se describe en la guía de autorización.
El campo userKey
es la dirección de correo electrónico principal del usuario en el informe o all
para todos los usuarios.
En el siguiente ejemplo, se recupera un informe de todas las actividades de creación de documentación de la cuenta. Para ver un ejemplo de una respuesta de la API, consulta la respuesta JSON de muestra:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?eventName=create
Ejemplo de respuesta JSON
Cuando realizas una solicitud GET
HTTP a la API, una respuesta correcta muestra un código de estado HTTP 200. Junto con el código de estado, la respuesta muestra un informe de la unidad. Estos informes también están disponibles en la
Consola del administrador. Si deseas obtener más información, consulta el Centro de ayuda para administradores de Google Workspace.
Para obtener información sobre eventName
, consulta la referencia Nombres de eventos de Drive. Si deseas obtener más información sobre las cadenas de consulta de la solicitud y las propiedades de respuesta, consulta la Referencia de la API.
{ "kind": "reports#auditActivities", "nextPageToken": "next page's token", "items": [ { "kind": "audit#activity", "id": { "time": "2014-03-17T15:39:18.460Z", "uniqQualifier": "report's unique ID", "applicationName": "drive", "customerId": "ABC123xyz" }, "actor": { "callerType": "USER", "email": "kim@example.com", "profileId": "user's unique Google Workspace profile ID", "key": "consumer key of requestor in an OAuth 2LO request" }, "ownerDomain": "domain of the source owner", "ipAddress": "user's IP address", "events": [ { "type": "access", "name": "edit", "parameters": [ { "name": "primary_event", "boolValue": true }, { "name": "owner_is_shared_drive", "boolValue": false }, { "name": "doc_id", "value": "1DWuYM3ot_sAyEQqOz0xWJ9bVMSYzOmRNeBqbgtSwuK8" }, { "name": "doc_title", "value": "Meeting notes" }, { "name": "doc_type", "value": "document" }, { "name": "owner", "value": "mary@example.com" } ] } ] }, ] }