El informe de actividad del administrador muestra información sobre las actividades de todos los administradores de tu cuenta en la Consola del administrador. Cada informe utiliza la solicitud básica del extremo del informe con parámetros específicos del informe, como el nombre del administrador o un evento específico de la Consola del administrador. El período máximo para cada informe corresponde a los últimos ciento ochenta días.
En este documento, se supone que ya completó correctamente los pasos previos para la configuración.
El informe de actividad del administrador solo se puede utilizar con fines legales de acuerdo con su Acuerdo de cliente. Y estos informes se aplican a las cuentas de Google Workspace, Education y ISP.
Recuperar todas las actividades administrativas
Para recuperar un informe de todas las actividades administrativas realizadas para una cuenta, usa la siguiente solicitud HTTP GET e incluye el token de autorización descrito en la documentación de autorización. Para obtener más información sobre las strings de consulta de la solicitud y las propiedades de respuesta, consulta la Referencia de la API. Para facilitar la lectura, el siguiente ejemplo tiene formato con retornos de línea:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?endTime=a date&startTime=a date &maxResults=number of events listed on each page of the report
El siguiente ejemplo obtiene un informe de todas las actividades administrativas de tu cuenta de los últimos 180 días, que es el período máximo para un informe. Y la string de consulta maxResults determina que este informe contiene dos eventos por página de informe. Para obtener un ejemplo de una respuesta de API, consulta el ejemplo de respuesta de JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=2
El siguiente ejemplo obtiene un informe de todas las actividades administrativas de un cliente durante los últimos 180 días. El customerId especifica para qué cliente se debe recuperar el informe.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?customerId=C03az79cb
Recuperar todas las actividades del administrador
Para recuperar un informe de todas las actividades de la Consola del administrador que realizó un administrador específico, usa la siguiente solicitud HTTP GET e incluye el token de autorización descrito en la documentación de autorización. userKey es la dirección de correo electrónico principal del administrador del informe. Para obtener más información sobre las strings de consulta de la solicitud y las propiedades de respuesta, consulta la Referencia de la API. Para facilitar la lectura, el siguiente ejemplo tiene formato con retornos de línea:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey /applications/admin?endTime=a date&startTime=a date &maxResults=number of events listed on each page of the report &filters=event name parameter relational operator parameter value
En el siguiente ejemplo, se obtiene un informe sobre todos los cambios en la aplicación de la Consola del administrador que realiza john@example.com y se filtra la respuesta para mostrar las actividades cuyo OLD_VALUE es igual a ALLOW_CAMERA. Para ver un ejemplo de una respuesta de API, consulta el ejemplo de respuesta de JSON. Para obtener información sobre las actividades, consulte los nombres de eventos de administrador:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA
Recuperar todas las actividades por nombre de evento
Para recuperar un informe de todas las actividades de un nombre de evento específico, usa la siguiente solicitud HTTP GET e incluye el token de autorización descrito en la documentación de autorización. Para obtener información sobre eventName, consulta la información de referencia de nombres de eventos de administrador. Para obtener más información sobre las strings de consulta de la solicitud y las propiedades de respuesta, consulta la Referencia de la API. Para facilitar la lectura, el siguiente ejemplo tiene formato con retornos de línea:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?endTime=a date&startTime=a date &maxResults=maximum number of events returned on a response page &eventName=name of the administrative event
En el siguiente ejemplo, se recupera un informe de todas las instancias de la Consola del administrador sobre el cambio del apellido de un usuario. Para obtener un ejemplo de una respuesta de API, consulta el ejemplo de respuesta de JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
Recuperar todas las actividades por evento y administrador
Para recuperar un informe de todos los cambios que realizó un administrador específico en la Consola del administrador, usa la siguiente solicitud HTTP GET e incluye el token de autorización que se describe en la documentación de autorización. userKey es la dirección de correo electrónico principal del administrador del informe. Para obtener información sobre eventName, consulta la información de referencia de nombres de eventos de administrador. Para obtener más información sobre las strings de consulta de la solicitud y las propiedades de respuesta, consulta la Referencia de la API. Para facilitar la lectura, el siguiente ejemplo tiene formato con retornos de línea:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey /applications/admin?endTime=a date&startTime=a date &maxResults=maximum number of events returned on a response page &eventName=name of the administrative event
En el siguiente ejemplo, se recupera un informe de todos los cambios de la Consola del administrador realizados en el apellido de un usuario específico realizado por john@example.com. Para obtener un ejemplo de una respuesta de API, consulta el ejemplo de respuesta de JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
Respuesta JSON de ejemplo del informe de actividad del administrador
Una respuesta correcta muestra un código de estado HTTP 200. Junto con el código de estado, la respuesta muestra un informe. Para obtener información sobre eventName, consulta la información de referencia de nombres de eventos de administrador. Para obtener más información sobre las strings de consulta de URL de la solicitud y las propiedades de respuesta, consulta la Referencia de la API.
{
"kind": "reports#auditActivities",
"nextPageToken": "the next page's token",
"items": [
{
"kind": "audit#activity",
"id": {
"time": "2011-06-17T15:39:18.460Z",
"uniqueQualifier": "report's unique ID",
"applicationName": "admin",
"customerId": "C03az79cb"
},
"actor": {
"callerType": "USER",
"email": "liz@example.com",
"profileId": "user's unique Google Workspace profile ID",
"key": "consumer key of requestor in OAuth 2LO requests"
},
"ownerDomain": "example.com",
"ipAddress": "user's IP address",
"events": [
{
"type": "GROUP_SETTINGS",
"name": "CHANGE_GROUP_SETTING",
"parameters": [
{
"name": "SETTING_NAME",
"value": "WHO_CAN_JOIN",
"intValue": "integer value of parameter",
"boolValue": "boolean value of parameter"
}
]
}
]
},
{
"kind": "audit#activity",
"id": {
"time": "2011-06-17T15:39:18.460Z",
"uniqueQualifier": "reports unique ID",
"applicationName": "admin",
"customerId": "C03az79cb"
},
"actor": {
"callerType": "USER",
"email": "liz@example.com",
"profileId": "user's unique Google Workspace profile ID",
"key": "consumer key of requestor in an OAuth 2LO request"
},
"ownerDomain": "example.com",
"ipAddress": "user's IP address",
"events": [
{
"type": "GROUP_SETTINGS",
"name": "CREATE_GROUP",
"parameters": [
{
"name": "GROUP_EMAIL",
"value": "helpdesk@example.com",
"intValue": "",
"boolValue": ""
}
]
}
]
}
]
}