- Richiesta HTTP
- Parametri percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- ChangeHistoryResourceType
- ActionType
- ChangeHistoryEvent
- ActorType
- ChangeHistoryChange
- ChangeHistoryResource
- Prova!
Cerca tra tutte le modifiche apportate a un account o ai relativi account secondari in base all'insieme di filtri specificato.
Richiesta HTTP
POST https://analyticsadmin.googleapis.com/v1alpha/{account=accounts/*}:searchChangeHistoryEvents
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
account |
Obbligatorio. La risorsa dell'account per la quale restituire le risorse di cronologia delle modifiche. Formato: accounts/{account} Esempio: |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "property": string, "resourceType": [ enum ( |
Campi | |
---|---|
property |
(Facoltativo) Nome della risorsa per una proprietà secondaria. Se impostato, restituisce solo le modifiche apportate a questa proprietà o alle relative risorse figlio. Formato: proprietà/{propertyId} Esempio: |
resourceType[] |
(Facoltativo) Se impostato, restituisce le modifiche solo se si riferiscono a una risorsa che corrisponde ad almeno uno di questi tipi. |
action[] |
(Facoltativo) Se impostato, restituisce solo le modifiche che corrispondono a uno o più di questi tipi di azioni. |
actorEmail[] |
(Facoltativo) Se impostato, restituisce le modifiche solo se sono state effettuate da un utente dell'elenco. |
earliestChangeTime |
(Facoltativo) Se impostato, restituisce solo le modifiche apportate dopo questo periodo di tempo (incluse). Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
latestChangeTime |
(Facoltativo) Se impostato, restituisce solo le modifiche apportate prima di questo momento (incluse). Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
pageSize |
(Facoltativo) Il numero massimo di elementi ChangeHistoryEvent da restituire. Il servizio potrebbe restituire un valore inferiore a questo valore, anche se sono presenti altre pagine. Se non specificato, verranno restituiti al massimo 50 articoli. Il valore massimo è 200 (i valori più alti verranno forzati al massimo). |
pageToken |
(Facoltativo) Un token di pagina, ricevuto da una precedente chiamata a |
Corpo della risposta
Messaggio di risposta per RPC SearchAccounts.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"changeHistoryEvents": [
{
object ( |
Campi | |
---|---|
changeHistoryEvents[] |
Risultati accessibili per il chiamante. |
nextPageToken |
Un token, che può essere inviato come |
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 dell'account |
PROPERTY |
Risorsa proprietà |
FIREBASE_LINK |
Risorsa FirebaseLink |
GOOGLE_ADS_LINK |
Risorsa Google AdsLink |
GOOGLE_SIGNALS_SETTINGS |
Risorsa GoogleSignalsSettings |
CONVERSION_EVENT |
Risorsa ConversionEvent |
MEASUREMENT_PROTOCOL_SECRET |
Risorsa MeasurementProtocolSecret |
CUSTOM_DIMENSION |
Risorsa CustomDimensione |
CUSTOM_METRIC |
Risorsa CustomMetrica |
DATA_RETENTION_SETTINGS |
Risorsa DataConservazioneSettings |
DISPLAY_VIDEO_360_ADVERTISER_LINK |
Risorsa DisplayVideo360AdvertiserLink |
DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL |
Risorsa DisplayVideo360AdvertiserLinkProposta |
SEARCH_ADS_360_LINK |
Risorsa link Search Ads360 |
DATA_STREAM |
Risorsa DataStream |
ATTRIBUTION_SETTINGS |
Risorsa AttributionSettings |
EXPANDED_DATA_SET |
Risorsa ExpandedDataSet |
CHANNEL_GROUP |
Risorsa ChannelGroup |
BIGQUERY_LINK |
Risorsa collegamento BigQuery |
ENHANCED_MEASUREMENT_SETTINGS |
Risorsa AdvancedMeasurementSettings |
DATA_REDACTION_SETTINGS |
Risorsa DataRedactionSettings |
SKADNETWORK_CONVERSION_VALUE_SCHEMA |
Risorsa SKAdNetworkConversionValueSchema |
ADSENSE_LINK |
Risorsa AdSenseLink |
AUDIENCE |
Risorsa del pubblico |
EVENT_CREATE_RULE |
Risorsa EventCreateRule |
CALCULATED_METRIC |
Risorsa CalcolataMetrica |
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 in un account Google Analytics o nelle relative proprietà secondarie derivanti dalla stessa causa. Le cause più comuni sono gli aggiornamenti apportati nell'interfaccia utente di Google Analytics, le modifiche effettuate dall'assistenza clienti o le modifiche automatiche al sistema Google Analytics.
Rappresentazione JSON |
---|
{ "id": string, "changeTime": string, "actorType": enum ( |
Campi | |
---|---|
id |
ID di questo evento di cronologia delle modifiche. Questo ID è univoco in Google Analytics. |
changeTime |
L'ora in cui è stata apportata la modifica. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
actorType |
Il tipo di attore che ha apportato questa modifica. |
userActorEmail |
Indirizzo email dell'Account Google che ha apportato la modifica. Questo sarà un indirizzo email valido se il campo dell'attore è impostato su USER, altrimenti vuoto. Gli Account Google eliminati causeranno un errore. |
changesFiltered |
Se impostato su true, l'elenco delle modifiche restituite è stato filtrato e non rappresenta tutte le modifiche apportate in questo evento. |
changes[] |
Un elenco delle modifiche apportate in questo evento di cronologia delle modifiche che corrispondono ai filtri specificati in SearchChangeHistoryEventsRequest. |
ActorType
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 di Google Analytics. |
SUPPORT |
Modifiche apportate dal personale del team di assistenza di Google Analytics. |
ChangeHistoryChange
Una descrizione di una modifica a una singola risorsa di Google Analytics.
Rappresentazione JSON |
---|
{ "resource": string, "action": enum ( |
Campi | |
---|---|
resource |
Nome della risorsa le cui modifiche sono descritte da questa voce. |
action |
Il tipo di azione che ha modificato questa risorsa. |
resourceBeforeChange |
Contenuti della risorsa precedenti alla modifica. Se la risorsa è stata creata in questa modifica, questo campo non sarà presente. |
resourceAfterChange |
Contenuti della risorsa successivi alla modifica. Se la risorsa è stata eliminata durante la 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 |
Campi | |
---|---|
Campo unione
|
|
account |
Un'istantanea di una risorsa account nella cronologia delle modifiche. |
property |
Un'istantanea di una risorsa Proprietà nella cronologia delle modifiche. |
firebaseLink |
Uno snapshot di una risorsa FirebaseLink nella cronologia delle modifiche. |
googleAdsLink |
Un'istantanea di una risorsa GoogleAdsLink nella cronologia delle modifiche. |
googleSignalsSettings |
Uno snapshot di una risorsa GoogleSignalsSettings nella cronologia delle modifiche. |
displayVideo360AdvertiserLink |
Un'istantanea di una risorsa DisplayVideo360AdvertiserLink nella cronologia delle modifiche. |
displayVideo360AdvertiserLinkProposal |
Un'istantanea di una risorsa DisplayVideo360AdvertiserLinkRecommendation nella cronologia delle modifiche. |
conversionEvent |
Uno snapshot di una risorsa ConversionEvent nella cronologia delle modifiche. |
measurementProtocolSecret |
Uno snapshot di una risorsa MeasurementProtocolSecret nella cronologia delle modifiche. |
customDimension |
Uno snapshot di una risorsa CustomDimensione nella cronologia delle modifiche. |
customMetric |
Uno snapshot di una risorsa CustomMetrica nella cronologia delle modifiche. |
dataRetentionSettings |
Uno snapshot di una risorsa per le impostazioni di conservazione dei dati nella cronologia delle modifiche. |
searchAds360Link |
Un'istantanea di una risorsa SearchAds360Link nella cronologia delle modifiche. |
dataStream |
Uno snapshot di una risorsa DataStream nella cronologia delle modifiche. |
attributionSettings |
Un'istantanea della risorsa AttributionSettings nella cronologia delle modifiche. |
expandedDataSet |
Uno snapshot di una risorsa ExpandedDataSet nella cronologia delle modifiche. |
channelGroup |
Un'istantanea di una risorsa ChannelGroup nella cronologia delle modifiche. |
bigqueryLink |
Uno snapshot di una risorsa link BigQuery nella cronologia delle modifiche. |
enhancedMeasurementSettings |
Un'istantanea della risorsa AdvancedMeasurementSettings nella cronologia delle modifiche. |
dataRedactionSettings |
Uno snapshot della risorsa DataRedactionSettings nella cronologia delle modifiche. |
skadnetworkConversionValueSchema |
Un'istantanea della risorsa SKAdNetworkConversionValueSchema nella cronologia delle modifiche. |
adsenseLink |
Un'istantanea di una risorsa AdSenseLink nella cronologia delle modifiche. |
audience |
Un'istantanea di una risorsa Audience nella cronologia delle modifiche. |
eventCreateRule |
Uno snapshot di una risorsa EventCreateRule nella cronologia delle modifiche. |
calculatedMetric |
Uno snapshot di una risorsa Calcolata nella cronologia delle modifiche. |