El informe de actividad de Drive proporciona información actividades 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 creados por un usuario en particular durante en un período específico. Puedes usar esta información para obtener una idea para mejorar la administración de contenido y posibles filtraciones de datos. Para obtener un informe, puedes usar la solicitud básica del extremo del informe con los parámetros específicos del informe, como un la dirección de correo electrónico de un usuario o un tipo específico de cambio en Google Drive. Los informes pueden incluyen datos de hasta los últimos 180 días.
El informe de actividad de Google Drive solo se puede usar con fines legales en las cuentas que tener 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 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 obtener una lista con los datos de tu
Documentos de Drive. Por ejemplo, puedes solicitar un informe que enumere
los 25 eventos de Drive más recientes de tu cuenta, que abarcan hasta 180
días. Para obtener este informe, obtén un token de autorización tal como se describe en
guía de autorización y, luego, utilice
la siguiente solicitud GET HTTP:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25
Puedes ver un ejemplo de respuesta para esta llamada a la API.
En el siguiente ejemplo, se recupera un informe de todos los datos de Drive eventos en los últimos 180 días, 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 un
solicitud HTTP GET con el token de autorización descrito en el
guía de autorización.
El campo userKey es la dirección de correo electrónico principal del usuario en el informe.
all para todos los usuarios.
En el siguiente ejemplo, se recupera un informe con una lista de 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 un recurso compartido específico
unidad mediante una solicitud GET HTTP con el token de autorización descrito en el
guía de autorización. Especifica el
dirección de correo electrónico del usuario con el que deseas ejecutar el informe en el campo userKey
o especifica all para ejecutar el informe de todos los usuarios.
En el siguiente ejemplo, se recupera un informe de todos los cambios de un recurso compartido específico unidad. 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 el doc_type. El
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
Si quieres recuperar eventos para los cambios de membresía, especifica el shared_drive_membership_change
para cada evento. 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 crear
o editar un documento, usa una solicitud GET HTTP con la autorización
token descrito en la guía de autorización.
El campo userKey es la dirección de correo electrónico principal del usuario en el informe.
all para todos los usuarios.
En el siguiente ejemplo, se recupera un informe de toda la creación de la documentación de la cuenta de datos. 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 devuelve un informe
para el Drive. Estos informes también están disponibles
Consola del administrador. Para obtener más información, consulta la
Centro de ayuda para administradores de Google Workspace.
Para obtener información sobre eventName, consulta la
Nombres de eventos de Drive
referencia. Para obtener más información sobre las cadenas de consulta de la solicitud y las
de respuesta, consulta la Referencia de 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"
}
]
}
]
},
]
}