Method: accounts.searchChangeHistoryEvents

Cerca tutte le modifiche apportate a un account o ai suoi account secondari in base al set di filtri specificato.

Restituisce solo il sottoinsieme di modifiche supportate dall'API. La UI potrebbe restituire ulteriori modifiche.

Richiesta HTTP

POST https://analyticsadmin.googleapis.com/v1alpha/{account=accounts/*}:searchChangeHistoryEvents

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
account

string

Obbligatorio. La risorsa account per cui restituire le risorse della cronologia delle modifiche. Formato: accounts/{account}

Esempio: accounts/100

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "property": string,
  "resourceType": [
    enum (ChangeHistoryResourceType)
  ],
  "action": [
    enum (ActionType)
  ],
  "actorEmail": [
    string
  ],
  "earliestChangeTime": string,
  "latestChangeTime": string,
  "pageSize": integer,
  "pageToken": string
}
Campi
property

string

Facoltativo. Nome della risorsa per una proprietà secondaria. Se impostato, restituisce solo le modifiche apportate a questa proprietà o alle relative risorse secondarie. Formato: properties/{propertyId}

Esempio: properties/100
resourceType[]

enum (ChangeHistoryResourceType)

Facoltativo. Se impostato, restituisce le modifiche solo se riguardano una risorsa che corrisponde ad almeno uno di questi tipi.
action[]

enum (ActionType)

Facoltativo. Se impostato, restituisce solo le modifiche che corrispondono a uno o più di questi tipi di azioni.
actorEmail[]

string

Facoltativo. Se impostato, restituisci le modifiche solo se apportate da un utente in questo elenco.
earliestChangeTime

string (Timestamp format)

Facoltativo. Se impostato, restituisce solo le modifiche apportate dopo questo orario (incluso).

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
latestChangeTime

string (Timestamp format)

Facoltativo. Se impostato, restituisce solo le modifiche apportate prima di questo orario (incluso).

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
pageSize

integer

Facoltativo. Il numero massimo di elementi ChangeHistoryEvent da restituire. Se non specificato, verranno restituiti al massimo 50 elementi. Il valore massimo è 200 (i valori superiori verranno forzati al massimo).

Tieni presente che il servizio potrebbe restituire una pagina con un numero di elementi inferiore a quello specificato da questo valore (potenzialmente anche zero) e che potrebbero essere presenti altre pagine. Se vuoi un determinato numero di elementi, dovrai continuare a richiedere pagine aggiuntive utilizzando pageToken finché non avrai ottenuto il numero necessario.
pageToken

string

Facoltativo. Un token di pagina, ricevuto da una precedente chiamata accounts.searchChangeHistoryEvents. Fornisci questo valore per recuperare la pagina successiva. Durante la paginazione, tutti gli altri parametri forniti a accounts.searchChangeHistoryEvents devono corrispondere alla chiamata che ha fornito il token di pagina.

Corpo della risposta

Messaggio di risposta per la RPC SearchAccounts.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "changeHistoryEvents": [
    {
      object (ChangeHistoryEvent)
    }
  ],
  "nextPageToken": string
}
Campi
changeHistoryEvents[]

object (ChangeHistoryEvent)

Risultati accessibili al chiamante.
nextPageToken

string

Un token, che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

ChangeHistoryResourceType

Tipi di risorse le cui modifiche possono essere restituite dalla cronologia delle modifiche.

Enum
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED Tipo di risorsa sconosciuto o non specificato.
ACCOUNT Risorsa account
PROPERTY Risorsa proprietà
GOOGLE_SIGNALS_SETTINGS Risorsa GoogleSignalsSettings
CONVERSION_EVENT Risorsa ConversionEvent
MEASUREMENT_PROTOCOL_SECRET Risorsa MeasurementProtocolSecret
CUSTOM_DIMENSION Risorsa CustomDimension
CUSTOM_METRIC Risorsa CustomMetric
DATA_RETENTION_SETTINGS Risorsa DataRetentionSettings
DATA_STREAM Risorsa DataStream
ATTRIBUTION_SETTINGS Risorsa AttributionSettings
EXPANDED_DATA_SET Risorsa ExpandedDataSet
CHANNEL_GROUP Risorsa ChannelGroup
ENHANCED_MEASUREMENT_SETTINGS Risorsa EnhancedMeasurementSettings
DATA_REDACTION_SETTINGS Risorsa DataRedactionSettings
SKADNETWORK_CONVERSION_VALUE_SCHEMA Risorsa SKAdNetworkConversionValueSchema
AUDIENCE Risorsa pubblico
EVENT_CREATE_RULE Risorsa EventCreateRule
KEY_EVENT Risorsa KeyEvent
CALCULATED_METRIC Risorsa CalculatedMetric
REPORTING_DATA_ANNOTATION Risorsa ReportingDataAnnotation
SUBPROPERTY_SYNC_CONFIG Risorsa SubpropertySyncConfig
REPORTING_IDENTITY_SETTINGS Risorsa ReportingIdentitySettings

ActionType

Tipi di azioni che possono modificare una risorsa.

Enum
ACTION_TYPE_UNSPECIFIED Tipo di azione sconosciuto o non specificato.
CREATED La risorsa è stata creata in questa modifica.
UPDATED La risorsa è stata aggiornata in questa modifica.
DELETED La risorsa è stata eliminata in questa modifica.

ChangeHistoryEvent

Un insieme di modifiche all'interno di un account Google Analytics o delle relative proprietà secondarie derivanti dalla stessa causa. Le cause comuni sono aggiornamenti apportati nell'interfaccia utente di Google Analytics, modifiche apportate dall'assistenza clienti o modifiche automatiche del sistema Google Analytics.

Rappresentazione JSON 
{
  "id": string,
  "changeTime": string,
  "actorType": enum (ActorType),
  "userActorEmail": string,
  "changesFiltered": boolean,
  "changes": [
    {
      object (ChangeHistoryChange)
    }
  ]
}
Campi
id

string

ID di questo evento della cronologia delle modifiche. Questo ID è univoco in Google Analytics.
changeTime

string (Timestamp format)

L'ora in cui è stata apportata la modifica.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
actorType

enum (ActorType)

Il tipo di attore che ha apportato questa modifica.
userActorEmail

string

L'indirizzo email dell'Account Google che ha apportato la modifica. Si tratterà di un indirizzo email valido se il campo attore è impostato su USER, altrimenti sarà vuoto. Gli Account Google eliminati causeranno un errore.
changesFiltered

boolean

Se è vero, l'elenco delle modifiche restituito è stato filtrato e non rappresenta tutte le modifiche apportate a questo evento.
changes[]

object (ChangeHistoryChange)

Un elenco delle modifiche apportate in questo evento della cronologia delle modifiche che corrispondono ai filtri specificati in SearchChangeHistoryEventsRequest.

ActorType

Diversi tipi di attori che possono apportare modifiche alle risorse Google Analytics.

Enum
ACTOR_TYPE_UNSPECIFIED Tipo di attore sconosciuto o non specificato.
USER Modifiche apportate dall'utente specificato in actorEmail.
SYSTEM Modifiche apportate dal sistema Google Analytics.
SUPPORT Modifiche apportate dal personale del team di assistenza Google Analytics.

ChangeHistoryChange

Una descrizione di una modifica a una singola risorsa Google Analytics.

Rappresentazione JSON 
{
  "resource": string,
  "action": enum (ActionType),
  "resourceBeforeChange": {
    object (ChangeHistoryResource)
  },
  "resourceAfterChange": {
    object (ChangeHistoryResource)
  }
}
Campi
resource

string

Nome della risorsa le cui modifiche sono descritte da questa voce.
action

enum (ActionType)

Il tipo di azione che ha modificato questa risorsa.
resourceBeforeChange

object (ChangeHistoryResource)

Contenuti della risorsa precedenti alla modifica. Se questa risorsa è stata creata in questa modifica, questo campo non sarà presente.
resourceAfterChange

object (ChangeHistoryResource)

Contenuti della risorsa successivi alla modifica. Se questa risorsa è stata eliminata in questa modifica, questo campo non sarà presente.

ChangeHistoryResource

Uno snapshot di una risorsa prima o dopo il risultato di una modifica nella cronologia delle modifiche.

Rappresentazione 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.
}
Campi

Campo unione resource.

resource può essere solo uno dei seguenti:
account

object (Account)

Uno snapshot di una risorsa Account nella cronologia delle modifiche.
property

object (Property)

Uno snapshot di una risorsa Proprietà nella cronologia delle modifiche.
googleSignalsSettings

object (GoogleSignalsSettings)

Un'istantanea di una risorsa GoogleSignalsSettings nella cronologia delle modifiche.
conversionEvent

object (ConversionEvent)

Uno snapshot di una risorsa ConversionEvent nella cronologia delle modifiche.
measurementProtocolSecret

object (MeasurementProtocolSecret)

Uno snapshot di una risorsa MeasurementProtocolSecret nella cronologia delle modifiche.
customDimension

object (CustomDimension)

Uno snapshot di una risorsa CustomDimension nella cronologia delle modifiche.
customMetric

object (CustomMetric)

Uno snapshot di una risorsa CustomMetric nella cronologia delle modifiche.
dataRetentionSettings

object (DataRetentionSettings)

Uno snapshot di una risorsa delle impostazioni di conservazione dei dati nella cronologia delle modifiche.
dataStream

object (DataStream)

Uno snapshot di una risorsa DataStream nella cronologia delle modifiche.
attributionSettings

object (AttributionSettings)

Uno snapshot della risorsa AttributionSettings nella cronologia delle modifiche.
expandedDataSet

object (ExpandedDataSet)

Uno snapshot di una risorsa ExpandedDataSet nella cronologia delle modifiche.
channelGroup

object (ChannelGroup)

Un'istantanea di una risorsa ChannelGroup nella cronologia delle modifiche.
enhancedMeasurementSettings

object (EnhancedMeasurementSettings)

Uno snapshot della risorsa EnhancedMeasurementSettings nella cronologia delle modifiche.
dataRedactionSettings

object (DataRedactionSettings)

Uno snapshot della risorsa DataRedactionSettings nella cronologia delle modifiche.
skadnetworkConversionValueSchema

object (SKAdNetworkConversionValueSchema)

Uno snapshot della risorsa SKAdNetworkConversionValueSchema nella cronologia delle modifiche.
audience

object (Audience)

Un'istantanea di una risorsa Audience nella cronologia delle modifiche.
eventCreateRule

object (EventCreateRule)

Uno snapshot di una risorsa EventCreateRule nella cronologia delle modifiche.
keyEvent

object (KeyEvent)

Uno snapshot di una risorsa KeyEvent nella cronologia delle modifiche.
calculatedMetric

object (CalculatedMetric)

Uno snapshot di una risorsa CalculatedMetric nella cronologia delle modifiche.
reportingDataAnnotation

object (ReportingDataAnnotation)

Uno snapshot di una risorsa ReportingDataAnnotation nella cronologia delle modifiche.
subpropertySyncConfig

object (SubpropertySyncConfig)

Uno snapshot di una risorsa SubpropertySyncConfig nella cronologia delle modifiche.
reportingIdentitySettings

object (ReportingIdentitySettings)

Uno snapshot di una risorsa ReportingIdentitySettings nella cronologia delle modifiche.