Method: accounts.searchChangeHistoryEvents

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

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. El recurso de la cuenta para el que se muestran 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. El nombre de recurso de una propiedad secundaria. Si se configura, solo mostrará los cambios realizados en esta propiedad o en sus recursos secundarios. Formato: properties/{propertyId} Ejemplo: "properties/100"
resourceType[]

enum (ChangeHistoryResourceType)

Opcional. Si se configura, solo se mostrarán los cambios si corresponden a un recurso que coincide con al menos uno de estos tipos.
action[]

enum (ActionType)

Opcional. Si se configura, solo se mostrarán los cambios que coincidan con uno o más de estos tipos de acciones.
actorEmail[]

string

Opcional. Si se configura, solo se mostrarán los cambios si los realizó un usuario de esta lista.
earliestChangeTime

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
latestChangeTime

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
pageSize

integer

Opcional. La cantidad máxima de elementos de ChangeHistoryEvent que se mostrarán. Es posible que el servicio muestre menos que este valor, incluso si hay páginas adicionales. Si no se especifica, se mostrarán 50 elementos como máximo. El valor máximo es 200 (los valores más altos se forzarán al máximo).
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 utiliza la paginación, todos los demás parámetros proporcionados a accounts.searchChangeHistoryEvents deben coincidir con la llamada que proporcionó el token de la página.

Cuerpo de la respuesta

Mensaje de respuesta para la RPC de SearchCuentas.

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 pudo acceder el emisor.
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.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

ChangeHistoryResourceType

Tipos de recursos cuyos cambios se pueden mostrar a partir del historial de cambios.

Enumeradores
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED Tipo de recurso desconocido o no especificado.
ACCOUNT Recurso de la cuenta
PROPERTY Recurso de propiedad
GOOGLE_SIGNALS_SETTINGS Recurso GoogleSignalsSettings
CONVERSION_EVENT Recurso de ConversionEvent
MEASUREMENT_PROTOCOL_SECRET Recurso MeasurementProtocolSecret
DATA_RETENTION_SETTINGS Recurso DataRetainSettings
DATA_STREAM Recurso de DataStream
ATTRIBUTION_SETTINGS Recurso AttributionSettings

ActionType

Tipos de acciones que pueden cambiar un recurso.

Enumeradores
ACTION_TYPE_UNSPECIFIED Tipo de acción desconocido o no especificado.
CREATED El recurso se creó en este cambio.
UPDATED Se actualizó el recurso con este cambio.
DELETED Se borró el recurso con este cambio.

ChangeHistoryEvent

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

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

string

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.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
actorType

enum (ActorType)

Indica el tipo de actor que realizó este cambio.
userActorEmail

string

Dirección de correo electrónico de la Cuenta de Google con la que se realizó el cambio Esta será una dirección de correo electrónico válida si el campo del actor está configurado como USER; de lo contrario, está vacío. Las Cuentas de Google que se borraron causarán un error.
changesFiltered

boolean

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

object (ChangeHistoryChange)

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

ActorType

Diferentes tipos de actores que pueden realizar cambios en los recursos de Google Analytics.

Enumeradores
ACTOR_TYPE_UNSPECIFIED Tipo de actor desconocido o no especificado.
USER Cambios que realizó el usuario especificado en actorEmail.
SYSTEM Cambios realizados por el sistema de Google Analytics.
SUPPORT Cambios que realizó el personal del equipo de asistencia al cliente de Google Analytics.

ChangeHistoryChange

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

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

string

Nombre del recurso del recurso cuyos cambios se describen en esta entrada.
action

enum (ActionType)

El tipo de acción que cambió este recurso.
resourceBeforeChange

object (ChangeHistoryResource)

Contenidos del recurso antes de realizar el cambio. Si este recurso se creó con este cambio, faltará este campo.
resourceAfterChange

object (ChangeHistoryResource)

Contenidos del recurso posterior a la implementación del cambio Si se borró el recurso durante el cambio, este campo no estará disponible.

ChangeHistoryResource

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)

Un resumen de un recurso de la cuenta en el historial de cambios.
property

object (Property)

Instantánea de un recurso de la propiedad en el historial de cambios.
conversionEvent

object (ConversionEvent)

Es un resumen de un recurso de ConversionEvent en el historial de cambios.
measurementProtocolSecret

object (MeasurementProtocolSecret)

Un resumen de un recurso MeasurementProtocolSecret en el historial de cambios.
dataRetentionSettings

object (DataRetentionSettings)

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.