Method: activities.list

Recupera una lista de actividades para la cuenta y la aplicación de un cliente específico, como la aplicación de la Consola del administrador o la aplicación de Google Drive. Para obtener más información, consulta las guías de los informes de actividad de los administradores y de Google Drive. Para obtener más información sobre los parámetros del informe de actividad, consulta las guías de referencia de los parámetros de actividad.

Solicitud HTTP

GET https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
userKey or all

string

Representa el ID de perfil o el correo electrónico del usuario para el que se deben filtrar los datos. Puede ser all para toda la información o userKey para el ID de perfil único de Google Workspace de un usuario o su dirección de correo electrónico principal. No debe ser un usuario borrado. En el caso de un usuario borrado, llama a users.list en la API de Directory con showDeleted=true y, luego, usa el objeto ID que se muestra como userKey.

applicationName

enum (ApplicationName)

Nombre de la aplicación para la que se recuperarán los eventos.

Parámetros de consulta

Parámetros
actorIpAddress

string

La dirección de protocolo de Internet (IP) del host donde se realizó el evento Esta es una forma adicional de filtrar el resumen de un informe mediante la dirección IP del usuario cuya actividad se informa. Esta dirección IP puede reflejar la ubicación física del usuario o no. Por ejemplo, la dirección IP puede ser la dirección del servidor proxy del usuario o la dirección de una red privada virtual (VPN). Este parámetro es compatible con las versiones de direcciones IPv4 y IPv6.

customerId

string

El ID único del cliente para el que se recuperan los datos.

endTime

string

Establece el final del período que se muestra en el informe. La fecha debe estar en el formato RFC 3339, por ejemplo, 2010-10-28T10:26:35.000Z. El valor predeterminado es la hora aproximada de la solicitud a la API. Un informe de la API tiene tres conceptos de tiempo básicos:

  • Fecha de la solicitud de un informe de la API: Momento en el que la API creó y recuperó el informe.
  • Hora de inicio del informe: Es el comienzo del período que se muestra en el informe. El startTime debe ser anterior a endTime (si se especifica) y la hora actual en la que se realizó la solicitud; de lo contrario, la API mostrará un error.
  • Hora de finalización del informe: Es el final del período que se muestra en el informe. Por ejemplo, el período de eventos resumido en un informe puede comenzar en abril y finalizar en mayo. El informe en sí se puede solicitar en agosto.
Si no se especifica el endTime, el informe muestra todas las actividades desde la startTime hasta la hora actual o los 180 días más recientes si startTime hace más de 180 días en el pasado.

eventName

string

El nombre del evento que consulta la API. Cada eventName está relacionada con una función o un servicio específico de Google Workspace que la API organiza en tipos de eventos. Un ejemplo son los eventos del Calendario de Google en los informes de la aplicación de la Consola del administrador. La estructura type de la configuración del calendario tiene todas las actividades eventName del calendario que informa la API. Cuando un administrador cambia un parámetro de configuración del Calendario, la API informa esta actividad en los parámetros type y eventName de la configuración del Calendario. Si deseas obtener más información sobre los parámetros y las cadenas de consulta de eventName, consulta la lista de nombres de eventos para varias aplicaciones que aparece más arriba en applicationName.

filters

string

La cadena de consulta filters es una lista separada por comas compuesta por parámetros de eventos manipulados por operadores relacionales. Los parámetros de eventos tienen el formato {parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},....

Estos parámetros de eventos están asociados con un eventName específico. Se muestra un informe vacío si el parámetro de la solicitud no pertenece a eventName. Para obtener más información sobre los campos eventName disponibles para cada aplicación y sus parámetros asociados, ve a la tabla ApplicationName y, luego, haz clic en la página Eventos de la actividad en el Apéndice de la aplicación que desees.

En los siguientes ejemplos de actividad de Drive, la lista que se muestra consta de todos los eventos edit en los que el valor del parámetro doc_id coincide con las condiciones definidas por el operador relacional. En el primer ejemplo, la solicitud muestra todos los documentos editados con un valor doc_id igual a 12345. En el segundo ejemplo, el informe muestra los documentos editados en los que el valor doc_id no es igual a 98765. El operador <> está codificado como URL en la cadena de consulta de la solicitud (%3C%3E):

GET...&eventName=edit&filters=doc_id==12345
GET...&eventName=edit&filters=doc_id%3C%3E98765

Una consulta filters admite estos operadores relacionales:

  • ==: "igual a".
  • <>: "no es igual a". Debe tener codificación URL (%3C%3E).
  • <: "menor que". Debe tener codificación URL (%3C).
  • <=: "menor que o igual a". Debe tener codificación URL (%3C=).
  • >: "mayor que". Debe tener codificación URL (%3E).
  • >=: "mayor que o igual a". Debe tener codificación URL (%3E=).

Nota: La API no acepta varios valores del mismo parámetro. Si se proporciona un parámetro más de una vez en la solicitud a la API, la API solo acepta el último valor de ese parámetro. Además, si se proporciona un parámetro no válido en la solicitud a la API, la API ignora ese parámetro y muestra la respuesta correspondiente a los parámetros válidos restantes. Si no se solicitan parámetros, se muestran todos los parámetros.

maxResults

integer

Determina cuántos registros de actividad se muestran en cada página de respuesta. Por ejemplo, si la solicitud establece maxResults=1 y el informe tiene dos actividades, el informe tendrá dos páginas. La propiedad nextPageToken de la respuesta tiene el token de la segunda página. La cadena de consulta maxResults es opcional en la solicitud. El valor predeterminado es 1,000.

orgUnitID

string

ID de la unidad organizativa de la que se debe generar el informe. Los registros de actividad solo se mostrarán a los usuarios que pertenezcan a la unidad organizativa especificada.

pageToken

string

El token que se especificará en la página siguiente. Un informe con varias páginas incluye una propiedad nextPageToken en la respuesta. En tu solicitud de seguimiento para obtener la siguiente página del informe, ingresa el valor nextPageToken en la cadena de consulta pageToken.

startTime

string

Establece el inicio del intervalo de tiempo que se muestra en el informe. La fecha debe estar en el formato RFC 3339, por ejemplo, 2010-10-28T10:26:35.000Z. El informe muestra todas las actividades desde el startTime hasta el endTime. El startTime debe ser anterior a endTime (si se especifica) y la hora actual en la que se realizó la solicitud; de lo contrario, la API mostrará un error.

groupIdFilter

string

Son los IDs de grupos separados por comas (ofuscados) en los que se filtran las actividades del usuario; es decir, la respuesta contendrá actividades solo para los usuarios que forman parte de al menos uno de los IDs de grupo mencionados aquí. Formato: “id:abc123,id:xyz456”

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Plantilla JSON para una colección de actividades.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (Activity)
    }
  ],
  "nextPageToken": string
}
Campos
kind

string

Es el tipo de recurso de la API. Para un informe de actividad, el valor es reports#activities.

etag

string

ETag del recurso.

items[]

object (Activity)

Cada actividad registrada en la respuesta

nextPageToken

string

Es el token para recuperar la página siguiente del informe. El valor nextPageToken se usa en la cadena de consulta pageToken de la solicitud.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/admin.reports.audit.readonly

Para obtener más información, consulta la guía de autorización.

ApplicationName

Enumeradores
access_transparency

Los informes de actividad de Transparencia de acceso de Google Workspace muestran información sobre diferentes tipos de eventos de actividad de Transparencia de acceso.

admin

Los informes de actividad de la aplicación de la Consola del administrador muestran información de la cuenta sobre diferentes tipos de eventos de actividad del administrador.

calendar

Los informes de actividad de la aplicación Calendario de Google muestran información sobre varios eventos de actividad de Calendario.

chat Los informes de actividad de Chat devuelven información sobre varios eventos de la actividad de Chat.
drive

Los informes de actividad de la aplicación de Google Drive muestran información sobre varios eventos de actividad de Google Drive. El informe de actividad de Drive solo está disponible para los clientes de Google Workspace Business y Enterprise.

gcp Los informes de actividad de la aplicación de Google Cloud Platform muestran información sobre varios eventos de actividad de GCP.
gplus Los informes de actividad de la aplicación Google+ devuelven información sobre varios eventos de actividad de Google+.
groups

Los informes de actividad de la aplicación de Grupos de Google muestran información sobre varios eventos de actividad de Grupos.

groups_enterprise

Los informes de actividad de grupos empresariales muestran información sobre varios eventos de actividad de grupos empresariales.

jamboard Los informes de actividad de Jamboard muestran información sobre diversos eventos de actividad de Jamboard.
login

Los informes de actividad de la aplicación de acceso muestran información de la cuenta sobre los diferentes tipos de eventos de actividad de acceso.

meet El informe de Actividad de auditoría de Meet muestra información sobre los diferentes tipos de eventos de actividad de auditoría de Meet.
mobile El informe Actividad de auditoría de dispositivos muestra información sobre diferentes tipos de eventos de actividad de auditoría de dispositivos.
rules

El informe Actividad de las reglas muestra información sobre diferentes tipos de eventos de actividad de las reglas.

saml

El informe de actividad de SAML muestra información sobre diferentes tipos de eventos de actividad de SAML.

token

Los informes de actividad de la aplicación de tokens muestran información de la cuenta sobre los diferentes tipos de eventos de actividad de tokens.

user_accounts

Los informes de actividad de la aplicación de Cuentas de usuario muestran información de la cuenta sobre los diferentes tipos de eventos de actividad de Cuentas de usuario.

context_aware_access

Los informes de actividad del acceso adaptado al contexto muestran información sobre los eventos denegados del acceso a los usuarios debido a las reglas de acceso adaptado al contexto.

chrome

Los informes de actividad de Chrome muestran información sobre los eventos del navegador Chrome y de ChromeOS.

data_studio Los informes de actividad de Data Studio muestran información sobre varios tipos de eventos de actividad de Data Studio.
keep Los informes de actividad de la aplicación de Keep muestran información sobre varios eventos de actividad de Google Keep. El informe de actividad de Keep solo está disponible para los clientes de Google Workspace Business y Enterprise.
vault Los informes de actividad de Vault devuelven información sobre varios tipos de eventos de actividad de Vault.

Actividad

Plantilla JSON para el recurso de la actividad

Representación JSON
{
  "kind": string,
  "etag": string,
  "ownerDomain": string,
  "ipAddress": string,
  "events": [
    {
      "type": string,
      "name": string,
      "parameters": [
        {
          "messageValue": {
            "parameter": [
              {
                object (NestedParameter)
              }
            ]
          },
          "name": string,
          "value": string,
          "multiValue": [
            string
          ],
          "intValue": string,
          "multiIntValue": [
            string
          ],
          "boolValue": boolean,
          "multiMessageValue": [
            {
              "parameter": [
                {
                  object (NestedParameter)
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "id": {
    "time": string,
    "uniqueQualifier": string,
    "applicationName": string,
    "customerId": string
  },
  "actor": {
    "profileId": string,
    "email": string,
    "callerType": string,
    "key": string
  }
}
Campos
kind

string

Es el tipo de recurso de la API. Para un informe de actividad, el valor es audit#activity.

etag

string

ETag de la entrada

ownerDomain

string

Este es el dominio que se ve afectado por el evento del informe. Por ejemplo, el dominio de la Consola del administrador o el propietario del documento de la aplicación de Drive.

ipAddress

string

Dirección IP del usuario que realiza la acción. Esta es la dirección de Protocolo de Internet (IP) del usuario cuando accede a Google Workspace, que puede o no reflejar su ubicación física. Por ejemplo, la dirección IP puede ser la dirección del servidor proxy del usuario o la dirección de una red privada virtual (VPN). La API es compatible con IPv4 y IPv6.

events[]

object

Eventos de actividad del informe

events[].type

string

Tipo de evento. El servicio o la función de Google Workspace que un administrador cambia se identifica en la propiedad type, que identifica un evento con la propiedad eventName. Para obtener una lista completa de las categorías type de la API, consulta la lista de nombres de eventos para varias aplicaciones mencionada anteriormente en applicationName.

events[].name

string

Nombre del evento. Este es el nombre específico de la actividad que informa la API. Además, cada eventName está relacionada con una función o servicio específico de Google Workspace que la API organiza en tipos de eventos.
Para los parámetros de solicitud eventName en general, haz lo siguiente:

  • Si no se proporciona un eventName, el informe muestra todas las instancias posibles de un eventName.
  • Cuando solicitas un eventName, la respuesta de la API muestra todas las actividades que contienen ese eventName.

Para obtener más información sobre las propiedades de eventName, consulta la lista de nombres de eventos para varias aplicaciones que aparece más arriba en applicationName.

events[].parameters[]

object

Pares de valores de parámetros para varias aplicaciones. Para obtener más información sobre los parámetros eventName, consulta la lista de nombres de eventos para varias aplicaciones que aparece más arriba en applicationName.

events[].parameters[].messageValue

object

Son los pares de valores del parámetro anidados asociados con este parámetro. El tipo de valor complejo de un parámetro se muestra como una lista de valores del parámetro. Por ejemplo, el parámetro de dirección puede tener un valor como [{parameter: [{name: city, value: abc}]}]

events[].parameters[].messageValue.parameter[]

object (NestedParameter)

Valores del parámetro

events[].parameters[].name

string

El nombre del parámetro.

events[].parameters[].value

string

Es el valor de cadena del parámetro.

events[].parameters[].multiValue[]

string

Son los valores de cadena del parámetro.

events[].parameters[].intValue

string (int64 format)

Es el valor entero del parámetro.

events[].parameters[].multiIntValue[]

string (int64 format)

Valores enteros del parámetro

events[].parameters[].boolValue

boolean

Es el valor booleano del parámetro.

events[].parameters[].multiMessageValue[]

object

activity.list de objetos messageValue.

events[].parameters[].multiMessageValue[].parameter[]

object (NestedParameter)

Valores del parámetro

id

object

Es el identificador único para cada registro de actividad.

id.time

string

Hora del inicio de la actividad. Está en el tiempo de época UNIX, expresado en segundos.

id.uniqueQualifier

string (int64 format)

Calificador único si varios eventos tienen el mismo tiempo

id.applicationName

string

Nombre de la aplicación a la que pertenece el evento Para conocer los valores posibles, consulta la lista de aplicaciones anterior en applicationName.

id.customerId

string

Es el identificador único de una cuenta de Google Workspace.

actor

object

Un usuario realiza la acción.

actor.profileId

string

Es el ID único del perfil de Google Workspace del actor. Es posible que este valor no esté presente si el actor no es un usuario de Google Workspace o puede ser el número 105250506097979753968 que actúa como un ID de marcador de posición.

actor.email

string

La dirección de correo electrónico principal del actor. Puede estar ausente si no hay una dirección de correo electrónico asociada con el actor.

actor.callerType

string

Es el tipo de actor.

actor.key

string

Solo está presente cuando callerType es KEY. Puede ser el consumer_key del solicitante de las solicitudes a la API de OAuth 2LO o un identificador de las cuentas de robot.