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 de extremo de informe básica 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 con fines lícitos en las cuentas que tengan asignada una licencia.
Para obtener información sobre las cadenas de consulta de la solicitud y las propiedades de 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.
Cómo recuperar eventos de Google Drive para un dominio
Puedes usar el informe de actividad de Drive para ver información sobre tus
documentos de Drive. Por ejemplo, puedes solicitar un informe con los 25 eventos de Drive más recientes de tu cuenta, que abarque 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, el período máximo.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive
Cómo recuperar 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 en el que se enumeran todos los cambios realizados por 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
Cómo recuperar eventos de Google Drive para unidades compartidas
Puedes recuperar un informe de las actividades de Google Drive de una unidad compartida específica con una solicitud HTTP GET con 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 en el que deseas ejecutar el informe en el campo userKey o especifica all para ejecutar el informe en 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 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 de cambios de membresía, especifica el evento shared_drive_membership_change. En el siguiente ejemplo, se recuperan todos los miembros agregados 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
Cómo recuperar 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 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 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 haces una solicitud HTTP GET 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 para la unidad. 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 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"
}
]
}
]
},
]
}