Method: accounts.searchChangeHistoryEvents

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Busca en todos los cambios de una cuenta o 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 cuenta para el cual se muestran los recursos del historial de cambios.

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. Nombre del recurso de una propiedad secundaria. Si se configura, solo muestra los cambios realizados en esta propiedad o sus recursos secundarios.

resourceType[]

enum (ChangeHistoryResourceType)

Opcional. Si se configura, solo muestra cambios si corresponden a un recurso que coincide con al menos uno de estos tipos.

action[]

enum (ActionType)

Opcional. Si se configura, solo muestra los cambios que coinciden con uno o más de estos tipos de acciones.

actorEmail[]

string

Opcional. Si se configura, solo muestra los cambios realizados por un usuario de esta lista.

earliestChangeTime

string (Timestamp format)

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

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

latestChangeTime

string (Timestamp format)

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

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

pageSize

integer

Opcional. La cantidad máxima de elementos ChangeHistoryEvent que se mostrarán. El servicio puede mostrar menos de 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 SearchChangeHistoryEvents anterior. Proporciona esto para recuperar la página siguiente. Al paginar, todos los demás parámetros proporcionados a SearchChangeHistoryEvents deben coincidir con la llamada que proporcionó el token de la página.

Cuerpo de la respuesta

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

Mensaje de respuesta para la RPC de SearchAccounts.

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.

Alcances de la autorización

Requiere el siguiente alcance de OAuth:

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

Tipo de recurso del historial de cambios

Tipos de recursos cuyos cambios se pueden mostrar desde el 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 de GoogleSignalsSettings
CONVERSION_EVENT Recurso de ConversionEvent
MEASUREMENT_PROTOCOL_SECRET Recurso MeasurementProtocolSecret
DATA_RETENTION_SETTINGS Recurso de DataretentionSettings
DATA_STREAM Recurso de DataStream
ATTRIBUTION_SETTINGS Recurso de AttributionSettings

Tipo de acción

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ó con este cambio.
UPDATED Se actualizó el recurso en este cambio.
DELETED Se borró el recurso en este cambio.

Evento de historial de cambios

Es un conjunto de cambios en una cuenta de Google Analytics o sus propiedades secundarias que se deben a 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 en nanosegundos y hasta nueve dígitos decimales. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

actorType

enum (ActorType)

El tipo de actor que hizo 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 actor está configurado en USER y vacío si no se establece. Las cuentas de Google que se borraron causarán un error.

changesFiltered

boolean

Si es verdadero, se filtró la lista de cambios mostrados y no representa todos los cambios que se produjeron en este evento.

changes[]

object (ChangeHistoryChange)

Una lista de los cambios realizados en este evento del historial de cambios que coinciden con los filtros especificados en SearchChangeHistoryEventsRequest.

Tipo de actor

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 realizados por el usuario especificado en actorEmail.
SYSTEM Cambios realizados por el sistema de Google Analytics.
SUPPORT Cambios realizados por el personal del equipo de asistencia de Google Analytics.

Cambio del historial de cambios

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

Nombre 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 de recursos anteriores al cambio. Si se creó este recurso en este cambio, faltará este campo.

resourceAfterChange

object (ChangeHistoryResource)

Contenidos de los recursos posteriores a la realización del cambio. Si se borró el recurso en este cambio, este campo faltará.

CambiarHistorialDeRecurso

Una instantánea de un recurso como 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)

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

property

object (Property)

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

conversionEvent

object (ConversionEvent)

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

measurementProtocolSecret

object (MeasurementProtocolSecret)

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

dataRetentionSettings

object (DataRetentionSettings)

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.