El informe de actividad del administrador muestra información sobre las actividades de la Consola del administrador de todos los administradores de tu cuenta. Cada informe usa la solicitud básica del extremo del informe con parámetros específicos del informe, como el nombre de un administrador o un evento específico de la Consola del administrador. El período máximo de cada informe son los últimos 180 días.
El informe de actividad del administrador solo se puede utilizar para fines lícitos de acuerdo con el Acuerdo del Cliente. Estos informes se aplican a las cuentas de ISP, Google Workspace y Education.
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 que se describe en la documentación de autorización. 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. Para facilitar la lectura, el siguiente ejemplo tiene un formato que permite mostrar resultados de líneas:
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
En el siguiente ejemplo, se obtiene un informe de todas las actividades administrativas de tu cuenta durante los últimos 180 días, que es el período máximo de un informe. Y la cadena de consulta maxResults determina que este informe contiene dos eventos por página. Para ver un ejemplo de una respuesta de la API, consulta el ejemplo de respuesta JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=2
En el siguiente ejemplo, se obtiene un informe de todas las actividades administrativas de un cliente durante los últimos 180 días. El customerId especifica para qué cliente se 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 que se describe en la documentación de autorización. La dirección de correo electrónico userKey es la dirección de correo electrónico principal del administrador en el informe. 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. Para facilitar la lectura, el siguiente ejemplo tiene un formato que permite mostrar resultados de líneas:
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 que realizó john@example.com en la aplicación de la Consola del administrador, y la respuesta se filtra para mostrar cualquier actividad que tenga un OLD_VALUE igual a ALLOW_CAMERA. Para ver un ejemplo de una respuesta de la API, consulta el ejemplo de respuesta JSON. Además, para obtener información sobre las actividades, consulta los nombres de los 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 que se describe en la documentación de autorización. Para obtener la información de eventName, consulta la información de referencia de los nombres de eventos de administrador. 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. Para facilitar la lectura, el siguiente ejemplo tiene un formato que permite mostrar resultados de líneas:
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 en las que se cambia el apellido de un usuario. Para ver un ejemplo de una respuesta de la API, consulta el ejemplo de respuesta 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 en la Consola del administrador de un nombre de evento específico que realizó un administrador específico, usa la siguiente solicitud HTTP GET e incluye el token de autorización que se describe en la documentación de autorización. La dirección de correo electrónico userKey es la dirección de correo electrónico principal del administrador en el informe. Para obtener la información de eventName, consulta la información de referencia de los nombres de eventos de administrador. 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. Para facilitar la lectura, el siguiente ejemplo tiene un formato que permite mostrar resultados de líneas:
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
El siguiente ejemplo recupera un informe de todos los cambios que realizó john@example.com en la Consola del administrador para el apellido de un usuario específico. Para ver un ejemplo de una respuesta de la API, consulta el ejemplo de respuesta JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
Ejemplo de respuesta JSON del informe de actividad del administrador
Si la respuesta es correcta, se mostrará un código de estado HTTP 200. Junto con el código de estado, la respuesta muestra un informe. Para obtener la información de eventName, consulta la información de referencia de los nombres de eventos de administrador. Para obtener más información sobre las cadenas de consulta de la URL de la solicitud y las propiedades de la 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": ""
}
]
}
]
}
]
}