Method: accounts.searchChangeHistoryEvents

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Ricerca in tutte le modifiche a un account o alle relative figlie, in base all'insieme di filtri specificato.

Richiesta HTTP

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

L'URL utilizza la sintassi gRPC Transcoding.

Parametri del percorso

Parametri
account

string

Obbligatorio. La risorsa dell'account per cui restituire le risorse della cronologia delle modifiche.

Corpo della richiesta

Il corpo della richiesta contiene i 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 figlio.

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, restituisce le modifiche solo se sono state effettuate da un utente presente in questo elenco.

earliestChangeTime

string (Timestamp format)

(Facoltativo) Se viene impostato, queste ultime vengono restituite solo dopo questo periodo (inclusi).

Un timestamp in formato RFC3339 UTC "Zulu", con una risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

latestChangeTime

string (Timestamp format)

(Facoltativo) Se impostato, restituisce solo le modifiche apportate prima di questo periodo (inclusi).

Un timestamp in formato RFC3339 UTC "Zulu", con una risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

pageSize

integer

(Facoltativo) Il numero massimo di elementi ChangeHistoryEvent da restituire. Il servizio potrebbe restituire un valore inferiore a questo valore, anche se sono presenti pagine aggiuntive. Se non è specificato alcun valore, verranno restituiti al massimo 50 articoli. Il valore massimo è 200 (i valori più elevati verranno spinti al massimo).

pageToken

string

(Facoltativo) Un token di pagina, ricevuto da una chiamata SearchChangeHistoryEvents precedente. Forniscilo per recuperare la pagina successiva. Durante l'impaginazione, tutti gli altri parametri forniti a SearchChangeHistoryEvents devono corrispondere alla chiamata che ha fornito il token della pagina.

Corpo della risposta

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

Messaggio di risposta per RPC SearchAccounts.

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

TipoCronologiaResourceModifica

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 dell'account
PROPERTY Risorsa della proprietà
GOOGLE_SIGNALS_SETTINGS Risorsa Impostazioni GoogleSignals
CONVERSION_EVENT Risorsa ConversionEvent
MEASUREMENT_PROTOCOL_SECRET Risorsa MeasurementProtocolSecret
DATA_RETENTION_SETTINGS Risorsa Impostazioni di conservazione dati
DATA_STREAM Risorsa DataStream
ATTRIBUTION_SETTINGS Risorsa AttributionSettings

Tipo di azione

Tipi di azioni che potrebbero modificare una risorsa.

Enum
ACTION_TYPE_UNSPECIFIED Tipo di azione sconosciuto o non specificato.
CREATED Risorsa creata in questa modifica.
UPDATED Risorsa aggiornata in questa modifica.
DELETED Risorsa eliminata in questa modifica.

Evento cronologia delle modifiche

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

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

string

ID dell'evento della cronologia delle modifiche. Questo ID è univoco in Google Analytics.

changeTime

string (Timestamp format)

L'ora in cui è stata apportata la modifica.

Un timestamp in formato RFC3339 UTC "Zulu", con una risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

actorType

enum (ActorType)

Il tipo di attore che ha apportato questa modifica.

userActorEmail

string

Indirizzo email dell'Account Google che ha apportato la modifica. Sarà un indirizzo email valido se il campo attore è impostato su USER e deve essere vuoto in caso contrario. Gli Account Google che sono stati eliminati causeranno un errore.

changesFiltered

boolean

Se restituisce true, l'elenco delle modifiche restituite è stato filtrato e non rappresenta tutte le modifiche apportate in questo evento.

changes[]

object (ChangeHistoryChange)

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

Tipo di attore

Diversi tipi di attori che possono apportare modifiche alle risorse di 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 di Google Analytics.

Modifica cronologia modifiche

Descrizione di una modifica a una singola risorsa di 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)

Contenuto della risorsa prima della modifica. Se la risorsa è stata creata in questa modifica, questo campo non sarà presente.

resourceAfterChange

object (ChangeHistoryResource)

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

Modifica Cronologia Storia

Un'istantanea di una risorsa come 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)
  },
  "conversionEvent": {
    object (ConversionEvent)
  },
  "measurementProtocolSecret": {
    object (MeasurementProtocolSecret)
  },
  "dataRetentionSettings": {
    object (DataRetentionSettings)
  },
  "dataStream": {
    object (DataStream)
  }
  // End of list of possible types for union field resource.
}
Campi

Campo unione resource.

resource può essere solo uno dei seguenti:

account

object (Account)

Un'istantanea di una risorsa account nella cronologia delle modifiche.

property

object (Property)

Uno snapshot di una risorsa della proprietà 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.

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.