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 utiliza 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 para cada informe es de los últimos 180 días.
El informe de actividad del administrador solo se puede usar para fines legales de conformidad con tu Acuerdo de Cliente. Además, estos informes se aplican a las cuentas de Google Workspace, Education y de ISP.
Recupera todas las actividades administrativas
Para recuperar un informe de todas las actividades administrativas realizadas en 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 el formato de saltos 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
En el siguiente ejemplo, se obtiene un informe sobre todas las actividades administrativas de tu cuenta durante los últimos 180 días, que es el período máximo para un informe.
La cadena de consulta maxResults determina que este informe contiene dos eventos por página del informe. Para ver un ejemplo de 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 sobre todas las actividades administrativas de un cliente durante los últimos 180 días. El parámetro 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
Recupera todas las actividades por administrador
Para recuperar un informe de todas las actividades de la Consola del administrador realizadas por un administrador específico, utiliza la siguiente solicitud HTTP GET e incluye el token de autorización que se describe en la documentación de autorización. El 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 saltos 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 realizados en la aplicación de la Consola del administrador por john@example.com, y la respuesta se filtra para devolver 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.
Para obtener información sobre las actividades, consulta los nombres de eventos del administrador:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA
Recupera todas las actividades por nombre del 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 información sobre eventName, consulta la información de referencia sobre los nombres de eventos del 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 saltos 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 en las que se cambió el apellido de un usuario. Para ver un ejemplo de 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
Recupera todas las actividades por evento y administrador
Para recuperar un informe de todos los cambios de la Consola del administrador para un nombre de evento específico realizado por 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. El userKey es la dirección de correo electrónico principal del administrador en el informe. Para obtener información sobre eventName, consulta la información de referencia sobre los nombres de eventos del 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 el formato de saltos 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 realizados en la Consola del administrador en el apellido de un usuario específico por john@example.com. Para ver un ejemplo de 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
Una respuesta correcta devuelve un código de estado HTTP 200.
Junto con el código de estado, la respuesta devuelve un informe. Para obtener información sobre eventName, consulta la información de referencia sobre los nombres de eventos del 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 requester 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 requester 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": "" } ] } ] } ] }