Method: accounts.searchChangeHistoryEvents

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

Solicitud HTTP

POST https://analyticsadmin.googleapis.com/v1alpha/{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: cuentas/{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 de recurso de una propiedad secundaria. Si se establece, solo muestra los cambios realizados en esta propiedad o sus recursos secundarios. Formato: properties/{propertyId}

Ejemplo: properties/100

resourceType[]

enum (ChangeHistoryResourceType)

Opcional. Si se establece, solo muestra los cambios si corresponden a 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 la estableces, se mostrarán los cambios solo 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 establece, solo muestra los cambios realizados antes 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".

pageSize

integer

Opcional. La cantidad máxima de elementos de ChangeHistoryEvent que se mostrarán. Es posible que el servicio muestre menos valores que este, incluso si hay páginas adicionales. Si no se especifica, se devolverán 50 artículos como máximo. El valor máximo es 200 (los valores más altos se fuerzan 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. Durante 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 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 Tipo de recurso desconocido o no especificado.
ACCOUNT Recurso de la cuenta
PROPERTY Recurso de la propiedad
GOOGLE_SIGNALS_SETTINGS Recurso GoogleSignalsSettings
CONVERSION_EVENT Recurso de 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 de AttributionSettings
EXPANDED_DATA_SET Recurso expandido de DataSet
CHANNEL_GROUP Recurso ChannelGroup
ENHANCED_MEASUREMENT_SETTINGS Recurso EnhancedMeasurementSettings
DATA_REDACTION_SETTINGS Recurso DataRedactionSettings
SKADNETWORK_CONVERSION_VALUE_SCHEMA Recurso SKAdNetworkConversionValueSchema
AUDIENCE Recurso de público
EVENT_CREATE_RULE Recurso EventCreateRule
CALCULATED_METRIC Recurso CalculatedMetric

ActionType

Tipos de acciones que pueden cambiar un recurso.

Enumeraciones
ACTION_TYPE_UNSPECIFIED Tipo de acción desconocido o no especificado.
CREATED El recurso se creó en este cambio.
UPDATED Se actualizó el recurso en 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 generaron a partir de la misma causa. Entre las causas comunes, se encuentran las actualizaciones realizadas en la IU de Google Analytics, los cambios en el servicio de 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

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)

El tipo de actor que realizó el 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)

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.

Enumeraciones
ACTOR_TYPE_UNSPECIFIED Tipo de actor desconocido o no especificado.
USER Los cambios realizados por el usuario especificado en actorEmail.
SYSTEM Los 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)

Contenido del recurso anterior al cambio. Si este recurso se creó en este cambio, faltará este campo.

resourceAfterChange

object (ChangeHistoryResource)

Contenido de recursos posterior al cambio. Si se borró este recurso en el 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)
  },
  "googleSignalsSettings": {
    object (GoogleSignalsSettings)
  },
  "displayVideo360AdvertiserLink": {
    object (DisplayVideo360AdvertiserLink)
  },
  "displayVideo360AdvertiserLinkProposal": {
    object (DisplayVideo360AdvertiserLinkProposal)
  },
  "conversionEvent": {
    object (ConversionEvent)
  },
  "measurementProtocolSecret": {
    object (MeasurementProtocolSecret)
  },
  "customDimension": {
    object (CustomDimension)
  },
  "customMetric": {
    object (CustomMetric)
  },
  "dataRetentionSettings": {
    object (DataRetentionSettings)
  },
  "searchAds360Link": {
    object (SearchAds360Link)
  },
  "dataStream": {
    object (DataStream)
  },
  "attributionSettings": {
    object (AttributionSettings)
  },
  "expandedDataSet": {
    object (ExpandedDataSet)
  },
  "channelGroup": {
    object (ChannelGroup)
  },
  "bigqueryLink": {
    object (BigQueryLink)
  },
  "enhancedMeasurementSettings": {
    object (EnhancedMeasurementSettings)
  },
  "dataRedactionSettings": {
    object (DataRedactionSettings)
  },
  "skadnetworkConversionValueSchema": {
    object (SKAdNetworkConversionValueSchema)
  },
  "adsenseLink": {
    object (AdSenseLink)
  },
  "audience": {
    object (Audience)
  },
  "eventCreateRule": {
    object (EventCreateRule)
  },
  "calculatedMetric": {
    object (CalculatedMetric)
  }
  // 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 Account en el historial de cambios.

property

object (Property)

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

googleSignalsSettings

object (GoogleSignalsSettings)

Un resumen de un recurso GoogleSignalsSettings en el historial de cambios.

conversionEvent

object (ConversionEvent)

Un resumen de un recurso de ConversionEvent en el historial de cambios.

measurementProtocolSecret

object (MeasurementProtocolSecret)

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

customDimension

object (CustomDimension)

Un resumen de un recurso CustomDimension en el historial de cambios.

customMetric

object (CustomMetric)

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

attributionSettings

object (AttributionSettings)

Un resumen del recurso AttributionSettings en el historial de cambios.

expandedDataSet

object (ExpandedDataSet)

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

channelGroup

object (ChannelGroup)

Un resumen de un recurso ChannelGroup en el historial de cambios.

enhancedMeasurementSettings

object (EnhancedMeasurementSettings)

Una instantánea del recurso EnhancedMeasurementSettings en el historial de cambios.

dataRedactionSettings

object (DataRedactionSettings)

Una instantánea del recurso DataRedactionSettings en el historial de cambios.

skadnetworkConversionValueSchema

object (SKAdNetworkConversionValueSchema)

Un resumen del recurso SKAdNetworkConversionValueSchema en el historial de cambios.

audience

object (Audience)

Un resumen de un recurso de público en el historial de cambios.

eventCreateRule

object (EventCreateRule)

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

calculatedMetric

object (CalculatedMetric)

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