Method: accounts.searchChangeHistoryEvents

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

Solo devuelve el subconjunto de cambios admitidos por la API. Es posible que la IU muestre cambios adicionales.

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

Es obligatorio. Es el recurso de la cuenta para el que se devolverán 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 configura, solo se devuelven 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 devuelven los cambios si son para un recurso que coincide con al menos uno de estos tipos.
action[]

enum (ActionType)

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

string

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

string (Timestamp format)

Opcional. Si se configura, solo se devuelven los cambios realizados después de esta fecha y hora (incluidas).

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "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 configura, solo se devuelven los cambios realizados antes de esta fecha y hora (incluidas).

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "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 devolverán. Si no se especifica, se devolverá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 devolver una página con menos elementos de los que especifica este valor (incluso cero) y que aún puede haber páginas adicionales. Si quieres una cantidad específica 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 la página.

Cuerpo de la respuesta

Es el 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)

Son los resultados a los que el llamador tenía acceso.
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 devolver 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
EXPANDED_DATA_SET Recurso ExpandedDataSet
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
KEY_EVENT Recurso KeyEvent
CALCULATED_METRIC Recurso CalculatedMetric
REPORTING_DATA_ANNOTATION Recurso ReportingDataAnnotation
SUBPROPERTY_SYNC_CONFIG Recurso SubpropertySyncConfig
REPORTING_IDENTITY_SETTINGS Recurso ReportingIdentitySettings

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

ChangeHistoryEvent

Conjunto de cambios dentro de una cuenta de Google Analytics o sus propiedades secundarias que se produjeron por la misma causa. Las causas comunes serían las actualizaciones realizadas en la IU de Google Analytics, los cambios del 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)

Fecha y hora en que se realizó el cambio.

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "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 actor que realizó este cambio.
userActorEmail

string

Dirección de correo electrónico de la Cuenta de Google que realizó el cambio. Será una dirección de correo electrónico válida si el campo actor se establece en USER y estará vacío en los demás casos. Las Cuentas de Google que se borraron generarán un error.
changesFiltered

boolean

Si es verdadero, significa que se filtró la lista de cambios que se devolvió y que 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 actores 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 Son los cambios que realiza 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

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

enum (ActionType)

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

object (ChangeHistoryResource)

Contenido del recurso antes de que se realizara el cambio. Si este recurso se creó en este cambio, faltará este campo.
resourceAfterChange

object (ChangeHistoryResource)

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)
  },
  "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)
  },
  "keyEvent": {
    object (KeyEvent)
  },
  "calculatedMetric": {
    object (CalculatedMetric)
  },
  "reportingDataAnnotation": {
    object (ReportingDataAnnotation)
  },
  "subpropertySyncConfig": {
    object (SubpropertySyncConfig)
  },
  "reportingIdentitySettings": {
    object (ReportingIdentitySettings)
  }
  // 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 una instantánea de un recurso de Account en el historial de cambios.
property

object (Property)

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

object (GoogleSignalsSettings)

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

object (ConversionEvent)

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

object (MeasurementProtocolSecret)

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

object (CustomDimension)

Es una instantánea de un recurso CustomDimension en el historial de cambios.
customMetric

object (CustomMetric)

Es una instantánea de un recurso CustomMetric 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)

Es una instantánea de un recurso de DataStream en el historial de cambios.
attributionSettings

object (AttributionSettings)

Es una instantánea del recurso AttributionSettings en el historial de cambios.
expandedDataSet

object (ExpandedDataSet)

Es una instantánea de un recurso ExpandedDataSet en el historial de cambios.
channelGroup

object (ChannelGroup)

Es una instantánea de un recurso de ChannelGroup en el historial de cambios.
enhancedMeasurementSettings

object (EnhancedMeasurementSettings)

Es una instantánea del recurso EnhancedMeasurementSettings en el historial de cambios.
dataRedactionSettings

object (DataRedactionSettings)

Es una instantánea del recurso DataRedactionSettings en el historial de cambios.
skadnetworkConversionValueSchema

object (SKAdNetworkConversionValueSchema)

Es una instantánea del recurso SKAdNetworkConversionValueSchema en el historial de cambios.
audience

object (Audience)

Es una instantánea de un recurso de Audience en el historial de cambios.
eventCreateRule

object (EventCreateRule)

Es una instantánea de un recurso EventCreateRule en el historial de cambios.
keyEvent

object (KeyEvent)

Es una instantánea de un recurso KeyEvent en el historial de cambios.
calculatedMetric

object (CalculatedMetric)

Es una instantánea de un recurso de CalculatedMetric en el historial de cambios.
reportingDataAnnotation

object (ReportingDataAnnotation)

Es un resumen de un recurso de ReportingDataAnnotation en el historial de cambios.
subpropertySyncConfig

object (SubpropertySyncConfig)

Es una instantánea de un recurso SubpropertySyncConfig en el historial de cambios.
reportingIdentitySettings

object (ReportingIdentitySettings)

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