Method: accounts.searchChangeHistoryEvents

Busca todos los cambios en una cuenta o sus elementos secundarios según el conjunto de filtros especificado.

Solo muestra el subconjunto de cambios que admite la API. Es posible que la IU muestre cambios adicionales.

Solicitud HTTP

POST https://analyticsadmin.googleapis.com/v1beta/{account=accounts/*}:searchChangeHistoryEvents

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

Parámetros de ruta de acceso

Parámetros
account

string

Obligatorio. Es el recurso de la cuenta para el que se deben mostrar los recursos del historial de cambios. Formato: accounts/{account}

Ejemplo: accounts/100

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "property": string,
  "resourceType": [
    enum (ChangeHistoryResourceType)
  ],
  "action": [
    enum (ActionType)
  ],
  "actorEmail": [
    string
  ],
  "earliestChangeTime": string,
  "latestChangeTime": string,
  "pageSize": integer,
  "pageToken": string
}
Campos
property

string

Opcional. Es el nombre del recurso de una propiedad secundaria. Si se establece, solo se muestran los cambios realizados en esta propiedad o en sus recursos secundarios. Formato: properties/{propertyId}

Ejemplo: properties/100
resourceType[]

enum (ChangeHistoryResourceType)

Opcional. Si se establece, solo muestra los cambios si son para un recurso que coincide con al menos uno de estos tipos.
action[]

enum (ActionType)

Opcional. Si se establece, solo se muestran los cambios que coinciden con uno o más de estos tipos de acciones.
actorEmail[]

string

Opcional. Si se establece, solo se muestran los cambios si los realiza un usuario de esta lista.
earliestChangeTime

string (Timestamp format)

Opcional. Si se establece, solo se mostrarán los cambios realizados después de este momento (inclusive).

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Por ejemplo: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
latestChangeTime

string (Timestamp format)

Opcional. Si se establece, solo se mostrarán los cambios realizados antes de esta hora (inclusive).

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Por ejemplo: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
pageSize

integer

Opcional. Es la cantidad máxima de elementos ChangeHistoryEvent que se mostrarán. Si no se especifica, se mostrarán como máximo 50 elementos. El valor máximo es 200 (los valores más altos se convertirán al máximo).

Ten en cuenta que el servicio puede mostrar una página con menos elementos que los que especifica este valor (incluso cero) y que aún puede haber páginas adicionales. Si quieres una cantidad determinada de elementos, deberás seguir solicitando páginas adicionales con pageToken hasta que obtengas la cantidad necesaria.
pageToken

string

Opcional. Un token de página, recibido desde una llamada accounts.searchChangeHistoryEvents anterior. Proporciona esto para recuperar la página siguiente. Cuando se realiza la paginación, todos los demás parámetros proporcionados a accounts.searchChangeHistoryEvents deben guardar correspondencia con la llamada que proporcionó el token de página.

Cuerpo de la respuesta

Es el mensaje de respuesta de la RPC de SearchAccounts.

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

Representación JSON 
{
  "changeHistoryEvents": [
    {
      object (ChangeHistoryEvent)
    }
  ],
  "nextPageToken": string
}
Campos
changeHistoryEvents[]

object (ChangeHistoryEvent)

Resultados a los que el llamador pudo acceder
nextPageToken

string

Un token, que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/analytics.edit

ChangeHistoryResourceType

Son los tipos de recursos cuyos cambios se pueden mostrar desde el historial de cambios.

Enumeraciones
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED El tipo de recurso es desconocido o no se especificó.
ACCOUNT Recurso de la cuenta
PROPERTY Recurso de propiedad
GOOGLE_SIGNALS_SETTINGS Recurso GoogleSignalsSettings
CONVERSION_EVENT Recurso ConversionEvent
MEASUREMENT_PROTOCOL_SECRET Recurso MeasurementProtocolSecret
CUSTOM_DIMENSION Recurso CustomDimension
CUSTOM_METRIC Recurso CustomMetric
DATA_RETENTION_SETTINGS Recurso DataRetentionSettings
DATA_STREAM Recurso de DataStream
ATTRIBUTION_SETTINGS Recurso AttributionSettings

ActionType

Son los tipos de acciones que pueden cambiar un recurso.

Enumeraciones
ACTION_TYPE_UNSPECIFIED El tipo de acción es desconocido o no se especificó.
CREATED Se creó un recurso en este cambio.
UPDATED Se actualizó el recurso en este cambio.
DELETED Se borró el recurso en este cambio.

ChangeHistoryEvent

Es un conjunto de cambios dentro de una cuenta de Google Analytics o sus propiedades secundarias que se deben a la misma causa. Las causas comunes son las actualizaciones realizadas en la IU de Google Analytics, los cambios realizados por el equipo de asistencia al cliente o los cambios automáticos del sistema de Google Analytics.

Representación JSON 
{
  "id": string,
  "changeTime": string,
  "actorType": enum (ActorType),
  "userActorEmail": string,
  "changesFiltered": boolean,
  "changes": [
    {
      object (ChangeHistoryChange)
    }
  ]
}
Campos
id

string

Es el ID de este evento del historial de cambios. Este ID es único en Google Analytics.
changeTime

string (Timestamp format)

Hora en la que se realizó el cambio.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Por ejemplo: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
actorType

enum (ActorType)

Es el tipo de agente que realizó este cambio.
userActorEmail

string

Dirección de correo electrónico de la Cuenta de Google que realizó el cambio Esta será una dirección de correo electrónico válida si el campo del actor está configurado como USUARIO y estará vacía en caso contrario. Las Cuentas de Google que se hayan borrado generarán un error.
changesFiltered

boolean

Si es verdadero, significa que la lista de cambios que se muestra se filtró y no representa todos los cambios que se produjeron en este evento.
changes[]

object (ChangeHistoryChange)

Es una lista de los cambios realizados en este evento del historial de cambios que se ajustan a los filtros especificados en SearchChangeHistoryEventsRequest.

ActorType

Son los diferentes tipos de partes que pueden realizar cambios en los recursos de Google Analytics.

Enumeraciones
ACTOR_TYPE_UNSPECIFIED Indica que el tipo de actor es desconocido o no se especificó.
USER Son los cambios que realizó el usuario especificado en actorEmail.
SYSTEM Cambios realizados por el sistema de Google Analytics
SUPPORT Cambios realizados por el personal del equipo de asistencia al cliente de Google Analytics

ChangeHistoryChange

Es una descripción de un cambio en un solo recurso de Google Analytics.

Representación JSON 
{
  "resource": string,
  "action": enum (ActionType),
  "resourceBeforeChange": {
    object (ChangeHistoryResource)
  },
  "resourceAfterChange": {
    object (ChangeHistoryResource)
  }
}
Campos
resource

string

Es el nombre del recurso cuyos cambios se describen en esta entrada.
action

enum (ActionType)

Es el tipo de acción que cambió este recurso.
resourceBeforeChange

object (ChangeHistoryResource)

Es el contenido del recurso anterior al cambio. Si este recurso se creó en este cambio, faltará este campo.
resourceAfterChange

object (ChangeHistoryResource)

Es el contenido del recurso después de que se realizó el cambio. Si este recurso se borró en este cambio, faltará este campo.

ChangeHistoryResource

Es una instantánea de un recurso antes o después del resultado de un cambio en el historial de cambios.

Representación JSON 
{

  // Union field resource can be only one of the following:
  "account": {
    object (Account)
  },
  "property": {
    object (Property)
  },
  "firebaseLink": {
    object (FirebaseLink)
  },
  "googleAdsLink": {
    object (GoogleAdsLink)
  },
  "conversionEvent": {
    object (ConversionEvent)
  },
  "measurementProtocolSecret": {
    object (MeasurementProtocolSecret)
  },
  "dataRetentionSettings": {
    object (DataRetentionSettings)
  },
  "dataStream": {
    object (DataStream)
  }
  // End of list of possible types for union field resource.
}
Campos

Campo de unión resource.

resource puede ser una de las siguientes opciones:
account

object (Account)

Es un resumen de un recurso de cuenta en el historial de cambios.
property

object (Property)

Es una instantánea de un recurso de propiedad en el historial de cambios.
conversionEvent

object (ConversionEvent)

Una instantánea de un recurso ConversionEvent en el historial de cambios.
measurementProtocolSecret

object (MeasurementProtocolSecret)

Es una instantánea de un recurso MeasurementProtocolSecret en el historial de cambios.
dataRetentionSettings

object (DataRetentionSettings)

Es una instantánea de un recurso de configuración de retención de datos en el historial de cambios.
dataStream

object (DataStream)

Una instantánea de un recurso de DataStream en el historial de cambios.