API de informes: Informe de actividad de Drive

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"
      }
      ]
     }
    ]
   },
  ]
 }