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 de extremo de 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 son los últimos 180 días.
El informe de actividad del administrador solo se puede utilizar para fines legales de conformidad con el Acuerdo con el Cliente. Estos informes se aplican a las cuentas de Google Workspace, Education y ISP.
Recupera todas las actividades administrativas
Para recuperar un informe de todas las actividades administrativas realizadas por una cuenta, usa la siguiente solicitud HTTP GET
e incluye el token de autorización descrito en la documentación de autorización. Si deseas 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 está formateado con líneas que muestran lo siguiente:
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. Y la cadena de búsqueda maxResults
determina que este informe contiene dos eventos por página de informe. Para ver un ejemplo de una respuesta a la API, consulta el ejemplo de respuesta de 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. 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 realizadas por 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. El userKey
es la dirección de correo electrónico principal del administrador del informe. Si deseas 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 está formateado con líneas que muestran lo siguiente:
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 realiza 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 a la API, consulta el ejemplo de respuesta de JSON. 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 descrito en la documentación de autorización. Para obtener información sobre eventName
, consulta la información de referencia sobre los nombres de los eventos de administrador. Si deseas 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 está formateado con líneas que muestran lo siguiente:
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 a la 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 por administrador
Para recuperar un informe de todos los cambios de la Consola del administrador correspondientes a 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 descrito en la documentación de autorización. El 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 sobre los nombres de los eventos de administrador. Si deseas 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 está formateado con líneas que muestran lo siguiente:
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 que realizó john@example.com
. Para ver un ejemplo de una respuesta a la 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
Ejemplo de respuesta JSON 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 sobre los nombres de los eventos de administrador. Si deseas obtener más información sobre las cadenas de consulta de 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": "" } ] } ] } ] }