Informe de actividad del administrador

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": ""
       }
      ]
     }
    ]
   }
  ]
 }