Method: accounts.searchChangeHistoryEvents

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

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 la estableces, solo mostrará los cambios que coincidan 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 muestra los cambios realizados después de este tiempo (inclusive).

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una 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 configura, solo se devuelven los cambios realizados antes de esta hora (incluida).

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una 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. Es la cantidad máxima de elementos ChangeHistoryEvent que se mostrarán. El servicio puede mostrar menos que este valor, incluso si hay páginas adicionales. Si no se especifica, se mostrarán como máximo 50 artículos. El valor máximo es 200 (los valores más altos se convertirá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 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 la página.

Cuerpo de la respuesta

Mensaje de respuesta para 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

Tipos de recursos cuyos cambios pueden mostrarse a partir del 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
DATA_RETENTION_SETTINGS Recurso DataRetentionSettings
DATA_STREAM Recurso de DataStream
ATTRIBUTION_SETTINGS Recurso AttributionSettings

ActionType

Tipos de acciones que pueden cambiar un recurso.

Enumeraciones
ACTION_TYPE_UNSPECIFIED El tipo de acción es desconocido o no se especificó.
CREATED El recurso se creó 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 en una cuenta de Google Analytics o sus propiedades secundarias que se generaron a partir de 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.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una 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)

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 se establece en USER. De lo contrario, estará vacío. Las Cuentas de Google que se hayan borrado causarán un error.
changesFiltered

boolean

Si es verdadero, se filtró la lista de cambios que se mostró y no representa todos los cambios que ocurrieron 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 Tipo de actor desconocido o no especificado.
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 la 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)

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)

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