El informe de 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 en particular durante un período 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 del extremo del 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 de Google Drive. Los informes pueden incluir datos de hasta los últimos 180 días.
El informe de actividad de Google Drive solo se puede usar para fines legales en las cuentas que tienen una licencia asignada.
Para obtener información sobre 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.
Recupera eventos de Google Drive para un dominio
Puedes usar el informe de actividad de Drive para enumerar 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 un ejemplo de respuesta 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 de Google Drive de un usuario en particular, usa una solicitud HTTP GET 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 que enumera todos los cambios realizados por el usuario especificado. Para ver un ejemplo de 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
Recupera eventos de Google Drive para unidades compartidas
Puedes recuperar un informe de las actividades de Google Drive para una unidad compartida específica con una solicitud GET de HTTP que incluya el token de autorización que se describe 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 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 con 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 cambios en la 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 de 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 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 HTTP GET a la API, una respuesta correcta devuelve un código de estado HTTP 200. Junto con el código de estado, la respuesta devuelve un informe de la unidad de Drive. Estos informes también están disponibles en la Consola del administrador. Para obtener más información, consulta el Centro de ayuda para administradores de Google Workspace.
Para obtener información sobre eventName, consulta la referencia de nombres de eventos de Drive. Para obtener más información sobre las cadenas de consulta de la solicitud y las propiedades de la 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"
}
]
}
]
},
]
}