Package google.analytics.admin.v1beta

Indice

AnalyticsAdminService

Interfaccia del servizio per l'API Analytics Admin (GA4).

AcknowledgeUserDataCollection

rpc AcknowledgeUserDataCollection(AcknowledgeUserDataCollectionRequest) returns (AcknowledgeUserDataCollectionResponse)

Accetta i termini per la raccolta dei dati utente per la proprietà specificata.

Questa accettazione deve essere completata (nell'interfaccia utente di Google Analytics o tramite questa API) prima che possano essere create risorse MeasurementProtocolSecret.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc ArchiveCustomDimension(ArchiveCustomDimensionRequest) returns (Empty)

Archivia una dimensione personalizzata su una proprietà.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc ArchiveCustomMetric(ArchiveCustomMetricRequest) returns (Empty)

Archivia una metrica personalizzata su una proprietà.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc CreateConversionEvent(CreateConversionEventRequest) returns (ConversionEvent)

Crea un evento di conversione con gli attributi specificati.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc CreateCustomDimension(CreateCustomDimensionRequest) returns (CustomDimension)

Crea una dimensione personalizzata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc CreateCustomMetric(CreateCustomMetricRequest) returns (CustomMetric)

Crea una metrica personalizzata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc CreateDataStream(CreateDataStreamRequest) returns (DataStream)

Crea un DataStream.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc CreateKeyEvent(CreateKeyEventRequest) returns (KeyEvent)

Crea un evento chiave.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc CreateMeasurementProtocolSecret(CreateMeasurementProtocolSecretRequest) returns (MeasurementProtocolSecret)

Crea un secret di Measurement Protocol.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc CreateProperty(CreatePropertyRequest) returns (Property)

Crea una proprietà "GA4" con la località e gli attributi specificati.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

Contrassegna l'account di destinazione come eliminato temporaneamente (ad es. "cestino") e lo restituisce.

Questa API non dispone di un metodo per ripristinare gli account eliminati temporaneamente. Tuttavia, possono essere ripristinati utilizzando l'interfaccia utente del Cestino.

Se gli account non vengono ripristinati prima della scadenza, l'account e tutte le risorse secondarie (ad es. Proprietà, GoogleAdsLink, Stream, AccessBindings) verranno eliminati definitivamente in modo definitivo. https://support.google.com/analytics/answer/6154772

Restituisce un errore se il target non viene trovato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc DeleteConversionEvent(DeleteConversionEventRequest) returns (Empty)

Elimina un evento di conversione in una proprietà.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc DeleteDataStream(DeleteDataStreamRequest) returns (Empty)

Elimina un elemento DataStream in una proprietà.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc DeleteKeyEvent(DeleteKeyEventRequest) returns (Empty)

Elimina un evento chiave.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc DeleteMeasurementProtocolSecret(DeleteMeasurementProtocolSecretRequest) returns (Empty)

Elimina MeasurementProtocolSecret di destinazione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc DeleteProperty(DeletePropertyRequest) returns (Property)

Contrassegna la proprietà target come eliminata temporaneamente (ad es. "cestino") e la restituisce.

Questa API non dispone di un metodo per ripristinare le proprietà eliminate temporaneamente. Tuttavia, possono essere ripristinati utilizzando l'interfaccia utente del Cestino.

Se le proprietà non vengono ripristinate prima della scadenza, la proprietà e tutte le risorse secondarie (ad es. GoogleAdsLink, Stream, AccessBindings) verranno eliminate definitivamente. https://support.google.com/analytics/answer/6154772

Restituisce un errore se il target non viene trovato o se non è una proprietà GA4.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc GetAccount(GetAccountRequest) returns (Account)

Esegui una ricerca per un singolo account.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

rpc GetConversionEvent(GetConversionEventRequest) returns (ConversionEvent)

Recupera un singolo evento di conversione.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

rpc GetCustomDimension(GetCustomDimensionRequest) returns (CustomDimension)

Cerca una singola dimensione personalizzata.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

rpc GetCustomMetric(GetCustomMetricRequest) returns (CustomMetric)

Cerca una singola metrica personalizzata.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

rpc GetDataRetentionSettings(GetDataRetentionSettingsRequest) returns (DataRetentionSettings)

Restituisce le impostazioni di conservazione dei dati singleton per questa proprietà.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

rpc GetDataSharingSettings(GetDataSharingSettingsRequest) returns (DataSharingSettings)

Ottieni le impostazioni di condivisione dei dati di un account. Le impostazioni di condivisione dei dati sono singleton.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

rpc GetDataStream(GetDataStreamRequest) returns (DataStream)

Ricerca di un singolo DataStream.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

rpc GetKeyEvent(GetKeyEventRequest) returns (KeyEvent)

Recupera un singolo evento chiave.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

rpc GetMeasurementProtocolSecret(GetMeasurementProtocolSecretRequest) returns (MeasurementProtocolSecret)

Ricerca di un singolo MeasurementProtocolSecret "GA4".

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

rpc GetProperty(GetPropertyRequest) returns (Property)

Cerca una singola proprietà "GA4".

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

rpc ListAccountSummaries(ListAccountSummariesRequest) returns (ListAccountSummariesResponse)

Restituisce i riepiloghi di tutti gli account accessibili al chiamante.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

Restituisce tutti gli account accessibili al chiamante.

Tieni presente che al momento questi account potrebbero non avere proprietà GA4. Gli account eliminati temporaneamente (ovvero "nel cestino") sono esclusi per impostazione predefinita. Restituisce un elenco vuoto se non vengono trovati account pertinenti.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

rpc ListConversionEvents(ListConversionEventsRequest) returns (ListConversionEventsResponse)

Restituisce un elenco di eventi di conversione nella proprietà principale specificata.

Restituisce un elenco vuoto se non vengono trovati eventi di conversione.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

rpc ListCustomDimensions(ListCustomDimensionsRequest) returns (ListCustomDimensionsResponse)

Elenca le dimensioni personalizzate di una proprietà.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

rpc ListCustomMetrics(ListCustomMetricsRequest) returns (ListCustomMetricsResponse)

Elenca le metriche personalizzate in una proprietà.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

rpc ListDataStreams(ListDataStreamsRequest) returns (ListDataStreamsResponse)

Elenca i DataStream in una proprietà.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

rpc ListKeyEvents(ListKeyEventsRequest) returns (ListKeyEventsResponse)

Restituisce un elenco di eventi chiave nella proprietà principale specificata. Restituisce un elenco vuoto se non vengono trovati eventi chiave.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

rpc ListMeasurementProtocolSecrets(ListMeasurementProtocolSecretsRequest) returns (ListMeasurementProtocolSecretsResponse)

Restituisce MeasurementProtocolSecretSecrets figlio sotto la proprietà principale specificata.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

rpc ListProperties(ListPropertiesRequest) returns (ListPropertiesResponse)

Restituisce le proprietà secondarie sotto l'account principale specificato.

Verranno restituite solo le proprietà "GA4". Le proprietà verranno escluse se il chiamante non ha accesso. Le proprietà eliminate temporaneamente (ossia "trasmesse") sono escluse per impostazione predefinita. Restituisce un elenco vuoto se non sono presenti proprietà pertinenti.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

rpc ProvisionAccountTicket(ProvisionAccountTicketRequest) returns (ProvisionAccountTicketResponse)

Richiede un ticket per la creazione di un account.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc RunAccessReport(RunAccessReportRequest) returns (RunAccessReportResponse)

Restituisce un report personalizzato dei record di accesso ai dati. Il report fornisce record di ogni lettura dei dati dei report di Google Analytics da parte di un utente. I record degli accessi vengono conservati per un massimo di due anni.

È possibile richiedere i report di accesso ai dati per una proprietà. I report possono essere richiesti per qualsiasi proprietà, ma le dimensioni non correlate alla quota possono essere richieste solo nelle proprietà Google Analytics 360. Questo metodo è disponibile solo per gli amministratori.

Questi record degli accessi ai dati includono i report sull'interfaccia utente di GA4, le esplorazioni dell'interfaccia utente di GA4, l'API di dati di GA4 e altri prodotti come Firebase e AdMob che possono recuperare i dati da Google Analytics tramite un collegamento. Questi record non includono le modifiche alla configurazione della proprietà, come l'aggiunta di uno stream o la modifica del fuso orario di una proprietà. Per la cronologia delle modifiche alla configurazione, consulta searchChangeHistoryEvents.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

rpc SearchChangeHistoryEvents(SearchChangeHistoryEventsRequest) returns (SearchChangeHistoryEventsResponse)

Cerca tutte le modifiche apportate a un account o ai relativi account secondari in base all'insieme di filtri specificato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

Aggiorna un account.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc UpdateConversionEvent(UpdateConversionEventRequest) returns (ConversionEvent)

Aggiorna un evento di conversione con gli attributi specificati.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc UpdateCustomDimension(UpdateCustomDimensionRequest) returns (CustomDimension)

Aggiorna una dimensione personalizzata su una proprietà.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc UpdateCustomMetric(UpdateCustomMetricRequest) returns (CustomMetric)

Aggiorna una metrica personalizzata su una proprietà.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc UpdateDataRetentionSettings(UpdateDataRetentionSettingsRequest) returns (DataRetentionSettings)

Aggiorna le impostazioni di conservazione dei dati singleton per questa proprietà.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc UpdateDataStream(UpdateDataStreamRequest) returns (DataStream)

Aggiorna un DataStream su una proprietà.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc UpdateKeyEvent(UpdateKeyEventRequest) returns (KeyEvent)

Aggiorna un evento chiave.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc UpdateMeasurementProtocolSecret(UpdateMeasurementProtocolSecretRequest) returns (MeasurementProtocolSecret)

Aggiorna un secret di Measurement Protocol.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc UpdateProperty(UpdatePropertyRequest) returns (Property)

Aggiorna una proprietà.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

AccessBetweenFilter

Esprimere che il risultato deve essere compreso tra due numeri (inclusi).

Campi
from_value

NumericValue

Inizia con questo numero.
to_value

NumericValue

Termina con questo numero.

AccessDateRange

Un intervallo di giorni contigui: startDate, startDate + 1, ..., endDate.

Campi
start_date

string

La data di inizio inclusiva per la query nel formato YYYY-MM-DD. Non può essere successiva a endDate. È accettato anche il formato NdaysAgo, yesterday o today e, in questo caso, la data viene dedotta in base all'ora corrente nel fuso orario della richiesta.
end_date

string

La data di fine inclusa per la query nel formato YYYY-MM-DD. Non può essere precedente al giorno startDate. È accettato anche il formato NdaysAgo, yesterday o today e, in questo caso, la data viene dedotta in base all'ora corrente nel fuso orario della richiesta.

AccessDimension

Le dimensioni sono attributi dei dati. Ad esempio, la dimensione userEmail indica l'email dell'utente che ha eseguito l'accesso ai dati dei report. I valori di dimensione nelle risposte al report sono stringhe.

Campi
dimension_name

string

Il nome API della dimensione. Consulta Schema di accesso ai dati per l'elenco delle dimensioni supportate in questa API.

In dimensionFilter e orderBys si fa riferimento alle dimensioni per nome.

AccessDimensionHeader

Descrive una colonna delle dimensioni nel report. Le dimensioni richieste in un report producono voci di colonna all'interno delle righe e delle intestazioni DimensioniHeader. Tuttavia, le dimensioni utilizzate esclusivamente all'interno di filtri o espressioni non producono colonne in un report e, di conseguenza, non generano intestazioni.

Campi
dimension_name

string

Il nome della dimensione, ad esempio "EmailUtente".

AccessDimensionValue

Il valore di una dimensione.

Campi
value

string

Il valore della dimensione. Ad esempio, questo valore può essere "Francia" per la dimensione "paese".

AccessFilter

Un'espressione per filtrare i valori delle dimensioni o delle metriche.

Campi
field_name

string

Il nome della dimensione o della metrica.
Campo di unione one_filter. Specifica un tipo di filtro per Filter. one_filter può essere solo uno dei seguenti:
string_filter

AccessStringFilter

Filtro correlato alle stringhe.
in_list_filter

AccessInListFilter

Un filtro per i valori nell'elenco.
numeric_filter

AccessNumericFilter

Un filtro per i valori numerici o di data.
between_filter

AccessBetweenFilter

Un filtro per due valori.

AccessFilterExpression

Esprime i filtri delle dimensioni o delle metriche. I campi nella stessa espressione devono essere tutte le dimensioni o tutte le metriche.

Campi
Campo di unione one_expression. Specifica un tipo di espressione di filtro per FilterExpression. one_expression può essere solo uno dei seguenti:
and_group

AccessFilterExpressionList

Ogni espressione Filtrata nel gruppo and ha una relazione AND.
or_group

AccessFilterExpressionList

Ciascuno dei filtriExpressions nel gruppo or_group ha una relazione OR.
not_expression

AccessFilterExpression

FiltroEspressione NON è di not_expression.
access_filter

AccessFilter

Un filtro primitivo. Nello stesso filtro Expression, tutti i nomi dei campi del filtro devono essere tutte le dimensioni o tutte le metriche.

AccessFilterExpressionList

Un elenco di espressioni di filtro.

Campi
expressions[]

AccessFilterExpression

Un elenco di espressioni di filtro.

AccessInListFilter

Il risultato deve essere incluso in un elenco di valori stringa.

Campi
values[]

string

L'elenco di valori stringa. Il campo non deve essere vuoto.
case_sensitive

bool

Se true, il valore della stringa è sensibile alle maiuscole.

AccessMetric

Le misurazioni quantitative di un report. Ad esempio, la metrica accessCount è il numero totale di record di accesso ai dati.

Campi
metric_name

string

Il nome API della metrica. Consulta Schema di accesso ai dati per l'elenco delle metriche supportate in questa API.

Le metriche vengono indicate per nome in metricFilter e orderBys.

AccessMetricHeader

Descrive una colonna di metriche nel report. Le metriche visibili richieste in un report producono voci di colonna all'interno di righe e MetricHeaders. Tuttavia, le metriche utilizzate esclusivamente all'interno di filtri o espressioni non producono colonne in un report e, di conseguenza, non producono intestazioni.

Campi
metric_name

string

Il nome della metrica; ad esempio, "accessCount".

AccessMetricValue

Il valore di una metrica.

Campi
value

string

Il valore di misurazione. Ad esempio, questo valore può essere "13".

AccessNumericFilter

Filtri per valori numerici o di data.

Campi
operation

Operation

Il tipo di operazione per questo filtro.
value

NumericValue

Un valore numerico o di data.

Operazione

L'operazione applicata a un filtro numerico.

Enum
OPERATION_UNSPECIFIED Non specificato.
EQUAL Uguale
LESS_THAN Minore di
LESS_THAN_OR_EQUAL Minore o uguale
GREATER_THAN Maggiore di
GREATER_THAN_OR_EQUAL Maggiore o uguale a

AccessOrderBy

I valori di Ordina per definiscono il modo in cui verranno ordinate le righe nella risposta. Ad esempio, ordinare le righe in base al numero di accessi decrescente è un ordine, mentre quello delle righe in base alla stringa del paese è un ordine diverso.

Campi
desc

bool

Se il valore è true, i dati vengono ordinati in ordine decrescente. Se il valore è false o non specificato, l'ordinamento viene ordinato in ordine crescente.
Campo di unione one_order_by. Specifica un tipo di ordine per per OrderBy. one_order_by può essere solo uno dei seguenti:
metric

MetricOrderBy

Ordina i risultati in base ai valori di una metrica.
dimension

DimensionOrderBy

Ordina i risultati in base ai valori di una dimensione.

DimensionOrderBy

Ordina in base ai valori delle dimensioni.

Campi
dimension_name

string

Un nome di dimensione nella richiesta in base a cui eseguire l'ordinamento.
order_type

OrderType

Controlla la regola per l'ordinamento dei valori delle dimensioni.

OrderType

Regola in base a cui ordinare i valori delle dimensioni stringa.

Enum
ORDER_TYPE_UNSPECIFIED Non specificato.
ALPHANUMERIC Ordinamento alfanumerico per punto di codice Unicode. Ad esempio, "2" < "A" < "X" < "b" < "z".
CASE_INSENSITIVE_ALPHANUMERIC Ordinamento alfanumerico senza distinzione tra maiuscole e minuscole per punto di codice Unicode minuscolo. Ad esempio, "2" < "A" < "b" < "X" < "z".
NUMERIC I valori delle dimensioni vengono convertiti in numeri prima dell'ordinamento. Ad esempio, nell'ordinamento NUMERIC, "25" < "100" e nell'ordinamento ALPHANUMERIC, "100" < "25". I valori di dimensione non numerici hanno tutti lo stesso valore di ordinamento sotto tutti i valori numerici.

MetricOrderBy

Ordina in base ai valori delle metriche.

Campi
metric_name

string

Il nome di una metrica nella richiesta in base a cui eseguire l'ordinamento.

AccessQuota

Stato attuale di tutte le quote per questa proprietà Analytics. Se una quota per una proprietà è esaurita, tutte le richieste a quella proprietà restituiranno errori di esaurimento risorse.

Campi
tokens_per_day

AccessQuotaStatus

Le proprietà possono utilizzare 250.000 token al giorno. La maggior parte delle richieste utilizza meno di 10 token.
tokens_per_hour

AccessQuotaStatus

Le proprietà possono utilizzare 50.000 token all'ora. Una richiesta API utilizza un unico numero di token, che viene detratto da tutte le quote orarie, giornaliere e per progetto.
concurrent_requests

AccessQuotaStatus

Le proprietà possono utilizzare fino a 50 richieste in parallelo.
server_errors_per_project_per_hour

AccessQuotaStatus

Le coppie di proprietà e di progetti cloud possono presentare fino a 50 errori del server all'ora.
tokens_per_project_per_hour

AccessQuotaStatus

Le proprietà possono utilizzare fino al 25% dei propri token per progetto all'ora. Ciò equivale a che le proprietà Analytics 360 possono utilizzare 12.500 token per progetto all'ora. Una richiesta API utilizza un unico numero di token, che viene detratto da tutte le quote orarie, giornaliere e per progetto.

AccessQuotaStatus

Stato attuale di un determinato gruppo di quote.

Campi
consumed

int32

Quota utilizzata da questa richiesta.
remaining

int32

Quota rimanente dopo questa richiesta.

AccessRow

Accedere ai dati dei report per ogni riga.

Campi
dimension_values[]

AccessDimensionValue

Elenco dei valori delle dimensioni. Questi valori sono nello stesso ordine specificato nella richiesta.
metric_values[]

AccessMetricValue

Elenco dei valori delle metriche. Questi valori sono nello stesso ordine specificato nella richiesta.

AccessStringFilter

Il filtro per le stringhe.

Campi
match_type

MatchType

Il tipo di corrispondenza per questo filtro.
value

string

Il valore stringa utilizzato per la corrispondenza.
case_sensitive

bool

Se true, il valore della stringa è sensibile alle maiuscole.

MatchType

Il tipo di corrispondenza di un filtro stringa.

Enum
MATCH_TYPE_UNSPECIFIED Non specificato
EXACT Corrispondenza esatta del valore della stringa.
BEGINS_WITH Inizia con il valore stringa.
ENDS_WITH Finisce con il valore stringa.
CONTAINS Contiene il valore della stringa.
FULL_REGEXP Corrispondenza completa per l'espressione regolare con il valore stringa.
PARTIAL_REGEXP Corrispondenza parziale per l'espressione regolare con il valore stringa.

Account

Un messaggio della risorsa che rappresenta un account Google Analytics.

Campi
name

string

Solo output. Nome risorsa di questo account. Formato: accounts/{account}. Esempio: "accounts/100"
create_time

Timestamp

Solo output. Data e ora della creazione originale dell'account.
update_time

Timestamp

Solo output. Data e ora dell'ultimo aggiornamento dei campi del payload dell'account.
display_name

string

Obbligatoria. Nome visualizzato leggibile per questo account.
region_code

string

Paese dell'attività. Deve essere un codice regione Unicode CLDR.
deleted

bool

Solo output. Indica se l'account è stato eliminato temporaneamente o meno. Gli account eliminati sono esclusi dai risultati dell'elenco, se non diversamente richiesto.
gmp_organization

string

Solo output. L'URI di una risorsa organizzazione di Google Marketing Platform. Impostato solo quando questo account è collegato a un'organizzazione GMP. Formato: marketingplatformadmin.googleapis.com/organizations/{org_id}

AccountSummary

Una risorsa virtuale che rappresenta una panoramica di un account e di tutte le relative proprietà GA4 figlio.

Campi
name

string

Nome risorsa per questo riepilogo dell'account. Formato: accountSummaries/{account_id} Esempio: "accountSummaries/1000"
account

string

Nome della risorsa dell'account a cui fa riferimento questo riepilogo dell'account Formato: accounts/{account_id} Esempio: "accounts/1000"
display_name

string

Nome visualizzato per l'account a cui si fa riferimento in questo riepilogo dell'account.
property_summaries[]

PropertySummary

Elenco di riepiloghi per gli account secondari di questo account.

AcknowledgeUserDataCollectionRequest

Messaggio di richiesta per RPC AcknowledgeUserDataCollection.

Campi
property

string

Obbligatoria. La proprietà per cui confermare la raccolta dei dati utente.
acknowledgement

string

Obbligatoria. Una conferma che il chiamante di questo metodo comprende i termini per la raccolta dei dati utente.

Questo campo deve contenere il valore esatto: "Confermo di aver ottenuto dagli utenti finali le autorizzazioni riguardanti le informative e i diritti sulla privacy necessarie per la raccolta e il trattamento dei loro dati, compresa l'associazione di tali dati alle informazioni sulle visite raccolte da Google Analytics tramite la proprietà della mia app e/o del mio sito".

AcknowledgeUserDataCollectionResponse

Questo tipo non contiene campi.

Messaggio di risposta per RPC AcknowledgeUserDataCollection.

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 durante questa modifica.
UPDATED La risorsa è stata aggiornata in questa modifica.
DELETED La risorsa è stata eliminata in questa modifica.

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 actor_email.
SYSTEM Modifiche apportate dal sistema Google Analytics.
SUPPORT Modifiche apportate dal personale del team di assistenza di Google Analytics.

ArchiveCustomDimensionRequest

Messaggio di richiesta per RPC ArchiveCustomSize.

Campi
name

string

Obbligatoria. Il nome della dimensione personalizzata da archiviare. Formato di esempio: property/1234/customDimensioni/5678

ArchiveCustomMetricRequest

Messaggio di richiesta per RPC ArchiveCustomMetric.

Campi
name

string

Obbligatoria. Il nome della metrica personalizzata da archiviare. Formato di esempio: Properties/1234/customMetrics/5678

ChangeHistoryChange

Descrizione di una modifica a una singola risorsa Google Analytics.

Campi
resource

string

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

ActionType

Il tipo di azione che ha modificato questa risorsa.
resource_before_change

ChangeHistoryResource

Contenuti delle risorse precedenti alla modifica. Se la risorsa è stata creata durante questa modifica, questo campo non sarà presente.
resource_after_change

ChangeHistoryResource

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

ChangeHistoryResource

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

Campi

Campo di unione resource.

resource può essere solo uno dei seguenti:
account

Account

Istantanea di una risorsa dell'account nella cronologia delle modifiche.
property

Property

Istantanea di una risorsa della proprietà nella cronologia delle modifiche.
conversion_event

ConversionEvent

Istantanea di una risorsa ConversionEvent nella cronologia delle modifiche.
measurement_protocol_secret

MeasurementProtocolSecret

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

DataRetentionSettings

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

DataStream

Uno snapshot di una risorsa DataStream nella cronologia delle modifiche.

ChangeHistoryEvent

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 del sistema di Google Analytics.

Campi
id

string

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

Timestamp

Data e ora in cui è stata apportata la modifica.
actor_type

ActorType

Il tipo di attore che ha apportato la modifica.
user_actor_email

string

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 che sono stati eliminati causeranno un errore.
changes_filtered

bool

Se il valore è true, l'elenco delle modifiche restituite è stato filtrato e non rappresenta tutte le modifiche apportate in questo evento.
changes[]

ChangeHistoryChange

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

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 della proprietà
GOOGLE_SIGNALS_SETTINGS Risorsa GoogleSignalsSettings
CONVERSION_EVENT Risorsa ConversionEvent
MEASUREMENT_PROTOCOL_SECRET Risorsa MeasurementProtocolSecret
DATA_RETENTION_SETTINGS Risorsa DataFidelizzazioneSettings
DATA_STREAM Risorsa DataStream
ATTRIBUTION_SETTINGS Risorsa AttributionSettings

ConversionEvent

Un evento di conversione in una proprietà Google Analytics.

Campi
name

string

Solo output. Nome risorsa di questo evento di conversione. Formato: proprietà/{property}/conversionEvents/{conversion_event}
event_name

string

Immutabile. Il nome dell'evento di conversione in questione. Esempi: "clic", "acquisto"
create_time

Timestamp

Solo output. L'ora in cui questo evento di conversione è stato creato nella proprietà.
deletable

bool

Solo output. Se impostato, al momento questo evento può essere eliminato con DeleteConversionEvent.
custom

bool

Solo output. Se è impostato su true, questo evento di conversione fa riferimento a un evento personalizzato. Se impostato su false, questo evento di conversione si riferisce a un evento predefinito in GA. Gli eventi predefiniti di solito hanno un significato speciale in GA. Gli eventi predefiniti vengono solitamente creati dal sistema GA, ma in alcuni casi possono essere creati dagli amministratori delle proprietà. Gli eventi personalizzati vengono conteggiati per il numero massimo di eventi di conversione personalizzati che è possibile creare per proprietà.
counting_method

ConversionCountingMethod

Campo facoltativo. Il metodo con cui verranno conteggiate le conversioni per più eventi all'interno di una sessione. Se questo valore non viene fornito, verrà impostato su ONCE_PER_EVENT.
default_conversion_value

DefaultConversionValue

Campo facoltativo. Definisce un valore/valuta predefinito per un evento di conversione.

ConversionCountingMethod

Il metodo con cui verranno conteggiate le conversioni per più eventi all'interno di una sessione.

Enum
CONVERSION_COUNTING_METHOD_UNSPECIFIED Metodo di conteggio non specificato.
ONCE_PER_EVENT Ogni istanza di evento è considerata una conversione.
ONCE_PER_SESSION Un'istanza di evento viene considerata una conversione al massimo una volta per sessione per utente.

DefaultConversionValue

Definisce un valore/valuta predefinito per un evento di conversione. È necessario indicare sia il valore che la valuta.

Campi
value

double

Questo valore verrà utilizzato per compilare il valore per tutte le conversioni dell'evento event_name specificato in cui il parametro "value" dell'evento non è impostato.
currency_code

string

Quando per un evento di conversione per event_name non è stata impostata una valuta, questa verrà applicata come predefinita. Deve essere nel formato del codice valuta ISO 4217. Per ulteriori informazioni, visita la pagina https://en.wikipedia.org/wiki/ISO_4217.

CreateConversionEventRequest

Messaggio di richiesta per RPC CreateConversionEvent

Campi
conversion_event

ConversionEvent

Obbligatoria. L'evento di conversione da creare.
parent

string

Obbligatoria. Il nome della risorsa della proprietà principale in cui verrà creato questo evento di conversione. Formato: proprietà/123

CreateCustomDimensionRequest

Messaggio di richiesta per RPC CreateCustomSize.

Campi
parent

string

Obbligatoria. Formato di esempio: Properties/1234
custom_dimension

CustomDimension

Obbligatoria. La dimensione personalizzata da creare.

CreateCustomMetricRequest

Messaggio di richiesta per RPC CreateCustomMetric.

Campi
parent

string

Obbligatoria. Formato di esempio: Properties/1234
custom_metric

CustomMetric

Obbligatoria. La metrica personalizzata da creare.

CreateDataStreamRequest

Messaggio di richiesta per RPC CreateDataStream.

Campi
parent

string

Obbligatoria. Formato di esempio: Properties/1234
data_stream

DataStream

Obbligatoria. Il DataStream da creare.

CreateFirebaseLinkRequest

Messaggio di richiesta per RPC CreateFirebaseLink

Campi
parent

string

Obbligatoria. Formato: Properties/{property_id} Esempio: Properties/1234

CreateGoogleAdsLinkRequest

Messaggio di richiesta per RPC CreateGoogleAdsLink

Campi
parent

string

Obbligatoria. Formato di esempio: Properties/1234

CreateKeyEventRequest

Messaggio di richiesta per RPC CreateKeyEvent

Campi
key_event

KeyEvent

Obbligatoria. L'evento chiave da creare.
parent

string

Obbligatoria. Il nome della risorsa della proprietà padre in cui verrà creato questo evento chiave. Formato: proprietà/123

CreateMeasurementProtocolSecretRequest

Messaggio di richiesta per RPC CreateMeasurementProtocolSecret

Campi
parent

string

Obbligatoria. La risorsa padre in cui verrà creato il secret. Formato: Properties/{property}/dataStreams/{dataStream}
measurement_protocol_secret

MeasurementProtocolSecret

Obbligatoria. Il secret di Measurement Protocol da creare.

CreatePropertyRequest

Messaggio di richiesta per RPC CreateProperty.

Campi
property

Property

Obbligatoria. La proprietà da creare. Nota: per la proprietà fornita deve essere specificata la proprietà principale.

CustomDimension

Una definizione di Dimensione personalizzata.

Campi
name

string

Solo output. Nome per questa risorsa CustomSize. Formato: proprietà/{property}/customDimensioni/{customDimensione}
parameter_name

string

Obbligatoria. Immutabile. Nome del parametro di tagging per questa dimensione personalizzata.

Se questa è una dimensione basata sugli utenti, il nome corrisponde al nome della proprietà utente. Se questa è una dimensione basata sugli eventi, questo è il nome del parametro evento.

Se questa è una dimensione basata sugli articoli, questo è il nome del parametro presente nell'array di articoli e-commerce.

Può contenere solo caratteri alfanumerici e trattini bassi, che iniziano con una lettera. Lunghezza massima di 24 caratteri per le dimensioni basate sugli utenti e 40 caratteri per le dimensioni basate sugli eventi.
display_name

string

Obbligatoria. Nome visualizzato per questa dimensione personalizzata, come mostrato nell'interfaccia utente di Analytics. Lunghezza massima di 82 caratteri, più spazi alfanumerici e trattini bassi che iniziano con una lettera. I nomi visualizzati precedenti generati dal sistema possono contenere parentesi quadre, ma gli aggiornamenti di questo campo non consentono mai l'utilizzo di parentesi quadre.
description

string

Campo facoltativo. Descrizione per questa dimensione personalizzata. La lunghezza massima è di 150 caratteri.
scope

DimensionScope

Obbligatoria. Immutabile. L'ambito di questa dimensione.
disallow_ads_personalization

bool

Campo facoltativo. Se il criterio viene impostato su true, la dimensione viene impostata come ANP e viene esclusa dalla personalizzazione degli annunci.

Al momento questa funzionalità è supportata solo per le dimensioni personalizzate basate sugli utenti.

DimensionScope

Valori validi per l'ambito di questa dimensione.

Enum
DIMENSION_SCOPE_UNSPECIFIED Ambito sconosciuto o non specificato.
EVENT Dimensione limitata a un evento.
USER Dimensione limitata a un utente.
ITEM Dimensione limitata agli articoli e-commerce

CustomMetric

La definizione di una metrica personalizzata.

Campi
name

string

Solo output. Nome per questa risorsa CustomMetric. Formato: proprietà/{property}/customMetrics/{customMetric}
parameter_name

string

Obbligatoria. Immutabile. Nome del tagging per questa metrica personalizzata.

Se si tratta di una metrica basata sugli eventi, questo è il nome del parametro evento.

Può contenere solo caratteri alfanumerici e trattini bassi, che iniziano con una lettera. Lunghezza massima di 40 caratteri per le metriche basate sugli eventi.
display_name

string

Obbligatoria. Nome visualizzato per questa metrica personalizzata come mostrato nell'interfaccia utente di Analytics. Lunghezza massima di 82 caratteri, più spazi alfanumerici e trattini bassi che iniziano con una lettera. I nomi visualizzati precedenti generati dal sistema possono contenere parentesi quadre, ma gli aggiornamenti di questo campo non consentono mai l'utilizzo di parentesi quadre.
description

string

Campo facoltativo. Descrizione per questa dimensione personalizzata. La lunghezza massima è di 150 caratteri.
measurement_unit

MeasurementUnit

Obbligatoria. Il tipo di valore della metrica personalizzata.
scope

MetricScope

Obbligatoria. Immutabile. L'ambito di questa metrica personalizzata.
restricted_metric_type[]

RestrictedMetricType

Campo facoltativo. Tipi di dati soggetti a limitazioni che possono essere contenuti in questa metrica. Obbligatorio per le metriche con unità di misura CURRENCY. Deve essere vuoto per le metriche con un'unità di misurazione non CURRENCY.

MeasurementUnit

Possibili tipi di rappresentazione del valore della metrica personalizzata.

La rappresentazione della valuta potrebbe cambiare in futuro e richiedere una modifica dell'API che provoca un errore.

Enum
MEASUREMENT_UNIT_UNSPECIFIED MeasurementUnit non specificato o mancante.
STANDARD Questa metrica utilizza unità predefinite.
CURRENCY Questa metrica misura una valuta.
FEET Questa metrica misura i piedi.
METERS Questa metrica misura gli metri.
KILOMETERS Questa metrica misura i chilometri.
MILES Questa metrica misura le miglia.
MILLISECONDS Questa metrica misura i millisecondi.
SECONDS Questa metrica misura i secondi.
MINUTES Questa metrica misura i minuti.
HOURS Questa metrica misura le ore.

MetricScope

L'ambito di questa metrica.

Enum
METRIC_SCOPE_UNSPECIFIED Ambito sconosciuto o non specificato.
EVENT Metrica limitata a un evento.

RestrictedMetricType

Etichette che contrassegnano i dati di questa metrica personalizzata come dati che devono essere limitati a utenti specifici.

Enum
RESTRICTED_METRIC_TYPE_UNSPECIFIED Tipo sconosciuto o non specificato.
COST_DATA I dati di costo nei report sulle metriche.
REVENUE_DATA La metrica registra i dati sulle entrate.

DataRetentionSettings

Impostazioni per la conservazione dei dati. Questa è una risorsa singleton.

Campi
name

string

Solo output. Nome della risorsa DataConservazioneSetting. Formato: proprietà/{property}/dataConservazioneSettings
event_data_retention

RetentionDuration

Il periodo di tempo in cui vengono conservati i dati a livello di evento.
reset_user_data_on_new_activity

bool

Se il valore è true, reimposta il periodo di conservazione per l'identificatore utente con ogni evento di quell'utente.

RetentionDuration

Valori validi per la durata di conservazione dei dati.

Enum
RETENTION_DURATION_UNSPECIFIED La durata del tempo di conservazione dei dati non è specificata.
TWO_MONTHS Il tempo di conservazione dei dati è di 2 mesi.
FOURTEEN_MONTHS Il tempo di conservazione dei dati è di 14 mesi.
TWENTY_SIX_MONTHS Il tempo di conservazione dei dati è di 26 mesi. Disponibile solo per le proprietà 360.
THIRTY_EIGHT_MONTHS Il tempo di conservazione dei dati è di 38 mesi. Disponibile solo per le proprietà 360.
FIFTY_MONTHS Il tempo di conservazione dei dati è di 50 mesi. Disponibile solo per le proprietà 360.

DataSharingSettings

Un messaggio della risorsa che rappresenta le impostazioni di condivisione dei dati di un account Google Analytics.

Campi
name

string

Solo output. Nome della risorsa. Formato: accounts/{account}/dataSharingSettings Esempio: "accounts/1000/dataSharingSettings"
sharing_with_google_support_enabled

bool

Consente all'Assistenza Google di accedere ai dati per contribuire a risolvere i problemi.
sharing_with_google_assigned_sales_enabled

bool

Consente ai team di vendita Google assegnati al cliente di accedere ai dati per suggerire modifiche alla configurazione e migliorare i risultati. Le limitazioni per i team di vendita continuano a essere applicate quando sono attivate.
sharing_with_google_any_sales_enabled

bool

Consente a tutte le vendite di Google di accedere ai dati per suggerire modifiche alla configurazione e migliorare i risultati.
sharing_with_google_products_enabled

bool

Consente a Google di utilizzare i dati per migliorare altri prodotti o servizi Google.
sharing_with_others_enabled

bool

Consente a Google di condividere con altri utenti i dati in forma aggregata e anonima.

DataStream

Un messaggio della risorsa che rappresenta uno stream di dati.

Campi
name

string

Solo output. Nome risorsa di questo stream di dati. Formato: Properties/{property_id}/dataStreams/{stream_id} Esempio: "properties/1000/dataStreams/2000"
type

DataStreamType

Obbligatoria. Immutabile. Il tipo di questa risorsa DataStream.
display_name

string

Nome visualizzato leggibile per lo stream di dati.

Obbligatorio per gli stream di dati web.

La lunghezza massima consentita del nome visualizzato è 255 unità di codice UTF-16.
create_time

Timestamp

Solo output. Data e ora della creazione originale dello stream.
update_time

Timestamp

Solo output. Data e ora dell'ultimo aggiornamento dei campi payload del flusso.
Campo di unione stream_data. Dati relativi a tipi di stream di dati specifici. Il messaggio che verrà impostato corrisponde al tipo di questo flusso. stream_data può essere solo uno dei seguenti:
web_stream_data

WebStreamData

Dati specifici per gli stream web. Deve essere compilato se il tipo è WEB_DATA_STREAM.
android_app_stream_data

AndroidAppStreamData

Dati specifici per gli stream di app Android. Deve essere compilato se il tipo è ANDROID_APP_DATA_STREAM.
ios_app_stream_data

IosAppStreamData

Dati specifici per gli stream di app per iOS. Deve essere compilato se il tipo è IOS_APP_DATA_STREAM.

AndroidAppStreamData

Dati specifici per gli stream di app Android.

Campi
firebase_app_id

string

Solo output. ID dell'app per Android corrispondente in Firebase, se presente. Questo ID può cambiare se l'app per Android viene eliminata e ricreata.
package_name

string

Immutabile. Il nome del pacchetto dell'app da misurare. Esempio: "com.example.myandroidapp"

DataStreamType

Il tipo di stream di dati.

Enum
DATA_STREAM_TYPE_UNSPECIFIED Tipo sconosciuto o non specificato.
WEB_DATA_STREAM Stream di dati web.
ANDROID_APP_DATA_STREAM Stream di dati dell'app per Android.
IOS_APP_DATA_STREAM Stream di dati dell'app per iOS.

IosAppStreamData

Dati specifici per gli stream di app per iOS.

Campi
firebase_app_id

string

Solo output. ID dell'app per iOS corrispondente in Firebase, se presente. Questo ID può cambiare se l'app per iOS viene eliminata e ricreata.
bundle_id

string

Obbligatoria. Immutabile. L'ID bundle dell'Apple App Store per l'app Esempio: "com.example.myiosapp"

WebStreamData

Dati specifici per gli stream web.

Campi
measurement_id

string

Solo output. ID misurazione di Analytics.

Esempio: "G-1A2BCD345E"
firebase_app_id

string

Solo output. ID dell'app web corrispondente in Firebase, se presente. Questo ID può cambiare se l'app web viene eliminata e ricreata.
default_uri

string

Nome di dominio dell'app web che viene misurata o vuoto. Esempio: "http://www.google.com", "https://www.google.com"

DeleteAccountRequest

Messaggio di richiesta per RPC DeleteAccount.

Campi
name

string

Obbligatoria. Il nome dell'account da eliminare temporaneamente. Formato: accounts/{account}. Esempio: "accounts/100"

DeleteConversionEventRequest

Messaggio di richiesta per RPC DeleteConversionEvent

Campi
name

string

Obbligatoria. Il nome della risorsa dell'evento di conversione da eliminare. Formato: proprietà/{property}/conversionEvents/{conversion_event} Esempio: "properties/123/conversionEvents/456"

DeleteDataStreamRequest

Messaggio di richiesta per RPC DeleteDataStream.

Campi
name

string

Obbligatoria. Il nome del DataStream da eliminare. Formato di esempio: Properties/1234/dataStreams/5678

DeleteFirebaseLinkRequest

Messaggio di richiesta per DeleteFirebaseLink RPC

Campi
name

string

Obbligatoria. Formato: Properties/{property_id}/firebaseLinks/{firebase_link_id} Esempio: Properties/1234/firebaseLinks/5678

DeleteGoogleAdsLinkRequest

Messaggio di richiesta per RPC DeleteGoogleAdsLink.

Campi
name

string

Obbligatoria. Formato di esempio: Properties/1234/googleAdsLinks/5678

DeleteKeyEventRequest

Messaggio di richiesta per RPC DeleteKeyEvent

Campi
name

string

Obbligatoria. Il nome della risorsa dell'evento chiave da eliminare. Formato: Properties/{property}/keyEvents/{key_event} Esempio: "properties/123/keyEvents/456"

DeleteMeasurementProtocolSecretRequest

Messaggio di richiesta per RPC DeleteMeasurementProtocolSecret

Campi
name

string

Obbligatoria. Il nome del MeasurementProtocolSecret da eliminare. Formato: proprietà/{property}/dataStreams/{dataStream}/measurementProtocolSecrets/{measurementProtocolSecret}

DeletePropertyRequest

Messaggio di richiesta per DeleteProperty RPC.

Campi
name

string

Obbligatoria. Il nome della proprietà da eliminare temporaneamente. Formato: Properties/{property_id} Esempio: "properties/1000"

GetAccountRequest

Messaggio di richiesta per RPC GetAccount.

Campi
name

string

Obbligatoria. Il nome dell'account da cercare. Formato: accounts/{account}. Esempio: "accounts/100"

GetConversionEventRequest

Messaggio di richiesta per RPC GetConversionEvent

Campi
name

string

Obbligatoria. Il nome della risorsa dell'evento di conversione da recuperare. Formato: proprietà/{property}/conversionEvents/{conversion_event} Esempio: "properties/123/conversionEvents/456"

GetCustomDimensionRequest

Messaggio di richiesta per RPC GetCustomSize.

Campi
name

string

Obbligatoria. Il nome della dimensione personalizzata da ottenere. Formato di esempio: property/1234/customDimensioni/5678

GetCustomMetricRequest

Messaggio di richiesta per GetCustomMetric RPC.

Campi
name

string

Obbligatoria. Il nome della metrica personalizzata da ottenere. Formato di esempio: Properties/1234/customMetrics/5678

GetDataRetentionSettingsRequest

Messaggio di richiesta per RPC GetDatakeepSettings.

Campi
name

string

Obbligatoria. Il nome delle impostazioni da cercare. Formato: proprietà/{property}/dataConservazioneSettings. Esempio: "properties/1000/dataConservazioneSettings"

GetDataSharingSettingsRequest

Messaggio di richiesta per RPC GetDataSharingSettings.

Campi
name

string

Obbligatoria. Il nome delle impostazioni da cercare. Formato: accounts/{account}/dataSharingSettings Esempio: "accounts/1000/dataSharingSettings"

GetDataStreamRequest

Messaggio di richiesta per GetDataStream RPC.

Campi
name

string

Obbligatoria. Il nome del DataStream da ottenere. Formato di esempio: Properties/1234/dataStreams/5678

GetKeyEventRequest

Messaggio di richiesta per RPC GetKeyEvent

Campi
name

string

Obbligatoria. Il nome della risorsa dell'evento chiave da recuperare. Formato: Properties/{property}/keyEvents/{key_event} Esempio: "properties/123/keyEvents/456"

GetMeasurementProtocolSecretRequest

Messaggio di richiesta per RPC con GetMeasurementProtocolSecret.

Campi
name

string

Obbligatoria. Il nome del secret di Measurement Protocol da cercare. Formato: proprietà/{property}/dataStreams/{dataStream}/measurementProtocolSecrets/{measurementProtocolSecret}

GetPropertyRequest

Messaggio di richiesta per GetProperty RPC.

Campi
name

string

Obbligatoria. Il nome della proprietà da cercare. Formato: Properties/{property_id} Esempio: "properties/1000"

IndustryCategory

La categoria selezionata per questa proprietà, utilizzata per il benchmarking di settore.

Enum
INDUSTRY_CATEGORY_UNSPECIFIED Categoria del settore non specificata
AUTOMOTIVE Auto e motori
BUSINESS_AND_INDUSTRIAL_MARKETS Mercati business e di settore
FINANCE Finanza
HEALTHCARE Sanità
TECHNOLOGY Tecnologia
TRAVEL Viaggiare
OTHER Altro
ARTS_AND_ENTERTAINMENT Arte e spettacolo
BEAUTY_AND_FITNESS Bellezza e fitness
BOOKS_AND_LITERATURE Libri e letteratura
FOOD_AND_DRINK Cibo e bevande
GAMES Giochi
HOBBIES_AND_LEISURE Hobby e tempo libero
HOME_AND_GARDEN Casa e giardino
INTERNET_AND_TELECOM Internet e telecomunicazioni
LAW_AND_GOVERNMENT Giustizia e pubblica amministrazione
NEWS Notizie
ONLINE_COMMUNITIES Comunità online
PEOPLE_AND_SOCIETY Persone e società
PETS_AND_ANIMALS Animali e animali da compagnia
REAL_ESTATE Immobiliare
REFERENCE Riferimento
SCIENCE Scienza
SPORTS Sport
JOBS_AND_EDUCATION Lavoro e istruzione
SHOPPING Shopping

KeyEvent

Un evento chiave in una proprietà Google Analytics.

Campi
name

string

Solo output. Nome risorsa di questo evento chiave. Formato: Properties/{property}/keyEvents/{key_event}
event_name

string

Immutabile. Il nome dell'evento chiave. Esempi: "clic", "acquisto"
create_time

Timestamp

Solo output. L'ora in cui è stato creato questo evento chiave nella proprietà.
deletable

bool

Solo output. Se è impostato su true, questo evento può essere eliminato.
custom

bool

Solo output. Se è impostato su true, questo evento chiave fa riferimento a un evento personalizzato. Se impostato su false, questo evento chiave fa riferimento a un evento predefinito in GA. In genere gli eventi predefiniti hanno un significato speciale in GA. In genere gli eventi predefiniti vengono creati automaticamente dal sistema GA, ma in alcuni casi possono essere creati dagli amministratori delle proprietà. Gli eventi personalizzati vengono conteggiati ai fini del numero massimo di eventi chiave personalizzati che è possibile creare per proprietà.
counting_method

CountingMethod

Obbligatoria. Il metodo con cui verranno conteggiati gli eventi chiave per più eventi all'interno di una sessione.
default_value

DefaultValue

Campo facoltativo. Definisce un valore/una valuta predefiniti per un evento chiave.

CountingMethod

Il metodo con cui verranno conteggiati gli eventi chiave per più eventi all'interno di una sessione.

Enum
COUNTING_METHOD_UNSPECIFIED Metodo di conteggio non specificato.
ONCE_PER_EVENT Ogni istanza di evento è considerata un evento chiave.
ONCE_PER_SESSION Un'istanza di evento è considerata un evento chiave al massimo una volta per sessione per utente.

DefaultValue

Definisce un valore/una valuta predefiniti per un evento chiave.

Campi
numeric_value

double

Obbligatoria. Verrà utilizzato per compilare il parametro "value" per tutte le occorrenze di questo evento chiave (specificato da event_name) in cui il parametro non è impostato.
currency_code

string

Obbligatoria. Quando un'occorrenza di questo evento chiave (specificato da event_name) non ha una valuta impostata, questa valuta verrà applicata come predefinita. Deve essere nel formato del codice valuta ISO 4217.

Per ulteriori informazioni, visita la pagina https://en.wikipedia.org/wiki/ISO_4217.

ListAccountSummariesRequest

Messaggio di richiesta per l'RPC ListAccountSummaries.

Campi
page_size

int32

Il numero massimo di risorse AccountSummary da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore, anche se sono presenti pagine aggiuntive. Se non specificati, verranno restituite al massimo 50 risorse. Il valore massimo è 200 (i valori più elevati verranno costretti a quello massimo)
page_token

string

Un token di pagina, ricevuto da una chiamata ListAccountSummaries precedente. Specifica questo valore per recuperare la pagina successiva. Durante l'impaginazione, tutti gli altri parametri forniti a ListAccountSummaries devono corrispondere alla chiamata che ha fornito il token della pagina.

ListAccountSummariesResponse

Messaggio di risposta per l'RPC ListAccountSummaries.

Campi
account_summaries[]

AccountSummary

Riepiloghi di tutti gli account a cui il chiamante ha accesso.
next_page_token

string

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

ListAccountsRequest

Messaggio di richiesta per RPC ListAccounts.

Campi
page_size

int32

Il numero massimo di risorse da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore, anche se sono presenti pagine aggiuntive. Se non specificati, verranno restituite al massimo 50 risorse. Il valore massimo è 200 (i valori più elevati verranno costretti a quello massimo)
page_token

string

Un token di pagina, ricevuto da una chiamata ListAccounts precedente. Specifica questo valore per recuperare la pagina successiva. Durante l'impaginazione, tutti gli altri parametri forniti a ListAccounts devono corrispondere alla chiamata che ha fornito il token della pagina.
show_deleted

bool

Indica se includere gli account eliminati temporaneamente (ad es. "cestinato") nei risultati. Gli account possono essere ispezionati per determinare se sono stati eliminati o meno.

ListAccountsResponse

Messaggio di richiesta per RPC ListAccounts.

Campi
accounts[]

Account

Risultati accessibili per il chiamante.
next_page_token

string

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

ListConversionEventsRequest

Messaggio di richiesta per RPC ListConversionEvents

Campi
parent

string

Obbligatoria. Il nome della risorsa della proprietà padre. Esempio: "properties/123"
page_size

int32

Il numero massimo di risorse da restituire. Se non specificati, verranno restituite al massimo 50 risorse. Il valore massimo è 200 (i valori più elevati verranno costretti a quello massimo)
page_token

string

Un token di pagina, ricevuto da una chiamata ListConversionEvents precedente. Specifica questo valore per recuperare la pagina successiva. Durante l'impaginazione, tutti gli altri parametri forniti a ListConversionEvents devono corrispondere alla chiamata che ha fornito il token della pagina.

ListConversionEventsResponse

Messaggio di risposta per ListConversionEvents RPC.

Campi
conversion_events[]

ConversionEvent

Gli eventi di conversione richiesti
next_page_token

string

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

ListCustomDimensionsRequest

Messaggio di richiesta per RPC ListCustomSize.

Campi
parent

string

Obbligatoria. Formato di esempio: Properties/1234
page_size

int32

Il numero massimo di risorse da restituire. Se non specificati, verranno restituite al massimo 50 risorse. Il valore massimo è 200 (i valori più elevati verranno costretti a raggiungere il massimo).
page_token

string

Un token di pagina, ricevuto da una chiamata ListCustomDimensions precedente. Specifica questo valore per recuperare la pagina successiva.

Durante l'impaginazione, tutti gli altri parametri forniti a ListCustomDimensions devono corrispondere alla chiamata che ha fornito il token della pagina.

ListCustomDimensionsResponse

Messaggio di risposta per RPC ListCustomDimensioni.

Campi
custom_dimensions[]

CustomDimension

Elenco delle dimensioni personalizzate.
next_page_token

string

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

ListCustomMetricsRequest

Messaggio di richiesta per RPC ListCustomMetrics.

Campi
parent

string

Obbligatoria. Formato di esempio: Properties/1234
page_size

int32

Il numero massimo di risorse da restituire. Se non specificati, verranno restituite al massimo 50 risorse. Il valore massimo è 200 (i valori più elevati verranno costretti a raggiungere il massimo).
page_token

string

Un token di pagina, ricevuto da una chiamata ListCustomMetrics precedente. Specifica questo valore per recuperare la pagina successiva.

Durante l'impaginazione, tutti gli altri parametri forniti a ListCustomMetrics devono corrispondere alla chiamata che ha fornito il token della pagina.

ListCustomMetricsResponse

Messaggio di risposta per l'RPC ListCustomMetrics.

Campi
custom_metrics[]

CustomMetric

Elenco di metriche personalizzate.
next_page_token

string

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

ListDataStreamsRequest

Messaggio di richiesta per RPC ListDataStreams.

Campi
parent

string

Obbligatoria. Formato di esempio: Properties/1234
page_size

int32

Il numero massimo di risorse da restituire. Se non specificati, verranno restituite al massimo 50 risorse. Il valore massimo è 200 (i valori più elevati verranno costretti a raggiungere il massimo).
page_token

string

Un token di pagina, ricevuto da una chiamata ListDataStreams precedente. Specifica questo valore per recuperare la pagina successiva.

Durante l'impaginazione, tutti gli altri parametri forniti a ListDataStreams devono corrispondere alla chiamata che ha fornito il token della pagina.

ListDataStreamsResponse

Messaggio di risposta per RPC ListDataStreams.

Campi
data_streams[]

DataStream

Elenco di DataStream.
next_page_token

string

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

ListFirebaseLinksRequest

Messaggio di richiesta per la RPC ListFirebaseLinks

Campi
parent

string

Obbligatoria. Formato: Properties/{property_id} Esempio: Properties/1234
page_size

int32

Il numero massimo di risorse da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore, anche se sono presenti pagine aggiuntive. Se non specificati, verranno restituite al massimo 50 risorse. Il valore massimo è 200 (i valori più elevati verranno costretti a quello massimo)
page_token

string

Un token di pagina, ricevuto da una chiamata ListFirebaseLinks precedente. Specifica questo valore per recuperare la pagina successiva. Durante l'impaginazione, tutti gli altri parametri forniti a ListFirebaseLinks devono corrispondere alla chiamata che ha fornito il token della pagina.

ListFirebaseLinksResponse

Messaggio di risposta per la RPC ListFirebaseLinks

Campi
next_page_token

string

Un token, che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine. Attualmente, Google Analytics supporta un solo FirebaseLink per proprietà, pertanto questo campo non verrà mai compilato.

ListGoogleAdsLinksRequest

Messaggio di richiesta per RPC di ListGoogleAdsLinks.

Campi
parent

string

Obbligatoria. Formato di esempio: Properties/1234
page_size

int32

Il numero massimo di risorse da restituire. Se non specificati, verranno restituite al massimo 50 risorse. Il valore massimo è 200 (i valori più elevati verranno costretti a raggiungere il massimo).
page_token

string

Un token di pagina, ricevuto da una chiamata ListGoogleAdsLinks precedente. Specifica questo valore per recuperare la pagina successiva.

Durante l'impaginazione, tutti gli altri parametri forniti a ListGoogleAdsLinks devono corrispondere alla chiamata che ha fornito il token della pagina.

ListGoogleAdsLinksResponse

Messaggio di risposta per ListGoogleAdsLinks RPC.

Campi
next_page_token

string

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

ListKeyEventsRequest

Messaggio di richiesta per RPC ListKeyEvents

Campi
parent

string

Obbligatoria. Il nome della risorsa della proprietà padre. Esempio: "properties/123"
page_size

int32

Il numero massimo di risorse da restituire. Se non specificati, verranno restituite al massimo 50 risorse. Il valore massimo è 200 (i valori più elevati verranno costretti a quello massimo)
page_token

string

Un token di pagina, ricevuto da una chiamata ListKeyEvents precedente. Specifica questo valore per recuperare la pagina successiva. Durante l'impaginazione, tutti gli altri parametri forniti a ListKeyEvents devono corrispondere alla chiamata che ha fornito il token della pagina.

ListKeyEventsResponse

Messaggio di risposta per ListKeyEvents RPC.

Campi
key_events[]

KeyEvent

Gli eventi chiave richiesti
next_page_token

string

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

ListMeasurementProtocolSecretsRequest

Messaggio di richiesta per RPC ListMeasurementProtocolSecret

Campi
parent

string

Obbligatoria. Il nome della risorsa dello stream padre. Formato: Properties/{property}/dataStreams/{dataStream}/measurementProtocolSecrets
page_size

int32

Il numero massimo di risorse da restituire. Se non specificati, verranno restituite al massimo 10 risorse. Il valore massimo è 10. I valori più alti verranno costretti al massimo.
page_token

string

Un token di pagina, ricevuto da una chiamata ListMeasurementProtocolSecrets precedente. Specifica questo valore per recuperare la pagina successiva. Durante l'impaginazione, tutti gli altri parametri forniti a ListMeasurementProtocolSecrets devono corrispondere alla chiamata che ha fornito il token della pagina.

ListMeasurementProtocolSecretsResponse

Messaggio di risposta per RPC ListMeasurementProtocolSecret

Campi
measurement_protocol_secrets[]

MeasurementProtocolSecret

Un elenco di secret per il flusso principale specificato nella richiesta.
next_page_token

string

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

ListPropertiesRequest

Messaggio di richiesta per RPC ListProperties.

Campi
filter

string

Obbligatoria. Un'espressione per filtrare i risultati della richiesta. I campi idonei per l'applicazione di filtri sono: parent:(il nome della risorsa dell'account o della proprietà principale) o ancestor:(il nome della risorsa dell'account principale) o firebase_project:(l'ID o il numero del progetto Firebase collegato). Alcuni esempi di filtri:

| Filter                      | Description                               |
|-----------------------------|-------------------------------------------|
| parent:accounts/123         | The account with account id: 123.       |
| parent:properties/123       | The property with property id: 123.       |
| ancestor:accounts/123       | The account with account id: 123.         |
| firebase_project:project-id | The firebase project with id: project-id. |
| firebase_project:123        | The firebase project with number: 123.    |
page_size

int32

Il numero massimo di risorse da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore, anche se sono presenti pagine aggiuntive. Se non specificati, verranno restituite al massimo 50 risorse. Il valore massimo è 200 (i valori più elevati verranno costretti a quello massimo)
page_token

string

Un token di pagina, ricevuto da una chiamata ListProperties precedente. Specifica questo valore per recuperare la pagina successiva. Durante l'impaginazione, tutti gli altri parametri forniti a ListProperties devono corrispondere alla chiamata che ha fornito il token della pagina.
show_deleted

bool

Indica se includere le proprietà eliminate temporaneamente (ovvero "trasmesse") nei risultati. Le proprietà possono essere ispezionate per determinare se sono state eliminate o meno.

ListPropertiesResponse

Messaggio di risposta per l'RPC ListProperties.

Campi
properties[]

Property

Risultati che corrispondono ai criteri di filtro ed sono stati accessibili al chiamante.
next_page_token

string

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

MeasurementProtocolSecret

Un valore del secret utilizzato per inviare hit a Measurement Protocol.

Campi
name

string

Solo output. Nome risorsa di questo secret. Questo secret può essere un elemento secondario di qualsiasi tipo di stream. Formato: proprietà/{property}/dataStreams/{dataStream}/measurementProtocolSecrets/{measurementProtocolSecret}
display_name

string

Obbligatoria. Nome visualizzato leggibile per questo secret.
secret_value

string

Solo output. Il valore del secret di Measurement Protocol. Passa questo valore al campo api_secret dell'API Measurement Protocol quando invii hit alla proprietà principale di questo secret.

NumericValue

Per rappresentare un numero.

Campi
Campo di unione one_value. Uno dei valori numerici one_value può essere solo uno dei seguenti:
int64_value

int64

Valore Integer
double_value

double

Valore doppio

Proprietà

Un messaggio della risorsa che rappresenta una proprietà GA4 di Google Analytics.

Campi
name

string

Solo output. Nome risorsa di questa proprietà. Formato: Properties/{property_id} Esempio: "properties/1000"
property_type

PropertyType

Immutabile. Il tipo di proprietà per questa risorsa della proprietà. Quando crei una proprietà, se il tipo è "PROPERTY_TYPE_UNSPECIFIED", sarà implicito "ORDINARY_PROPERTY".
create_time

Timestamp

Solo output. L'ora in cui è stata creata inizialmente l'entità.
update_time

Timestamp

Solo output. Data e ora dell'ultimo aggiornamento dei campi del payload dell'entità.
parent

string

Immutabile. Nome della risorsa dell'elemento padre logico di questa proprietà.

Nota: l'interfaccia utente di spostamento proprietà può essere utilizzata per cambiare l'elemento principale. Formato: accounts/{account}, proprietà/{property}. Esempio: "accounts/100", "properties/101"
display_name

string

Obbligatoria. Nome visualizzato leggibile per questa proprietà.

La lunghezza massima consentita per il nome visualizzato è di 100 unità di codice UTF-16.
industry_category

IndustryCategory

Settore associato a questa proprietà Esempio: AUTOMOTIVE, FOOD_AND_DRINK
time_zone

string

Obbligatoria. Fuso orario dei report, utilizzato come giorno limite per i report, a prescindere dalla località di origine dei dati. Se il fuso orario rispetta l'ora legale, Analytics regola automaticamente le modifiche.

NOTA: la modifica del fuso orario influisce solo sui dati raccolti da quel momento in poi e non su quelli raccolti in precedenza.

Formato: https://www.iana.org/time-zones Esempio: "America/Los_Angeles"
currency_code

string

Il tipo di valuta utilizzato nei report relativi a valori monetari.

Formato: https://en.wikipedia.org/wiki/ISO_4217 Esempi: "USD", "EUR", "JPY"
service_level

ServiceLevel

Solo output. Il livello di servizio di Google Analytics che si applica a questa proprietà.
delete_time

Timestamp

Solo output. Se impostata, l'ora in cui la proprietà è stata spostata nel cestino. Se non viene configurato, significa che al momento la proprietà non è nel cestino.
expire_time

Timestamp

Solo output. Se impostata, l'ora in cui la proprietà cestinata sarà eliminata definitivamente. Se non viene configurato, significa che al momento la proprietà non è nel cestino e non è prevista l'eliminazione.
account

string

Immutabile. Il nome della risorsa dell'account principale Formato: accounts/{account_id} Esempio: "accounts/123"

PropertySummary

Una risorsa virtuale che rappresenta i metadati per una proprietà GA4.

Campi
property

string

Nome della risorsa della proprietà a cui fa riferimento questo riepilogo della proprietà Formato: Properties/{property_id} Esempio: "properties/1000"
display_name

string

Nome visualizzato della proprietà a cui viene fatto riferimento in questo riepilogo della proprietà.
property_type

PropertyType

Il tipo di proprietà.
parent

string

Nome della risorsa dell'elemento padre logico di questa proprietà.

Nota: l'interfaccia utente di spostamento proprietà può essere utilizzata per cambiare l'elemento principale. Formato: accounts/{account}, proprietà/{property}. Esempio: "accounts/100", "properties/200"

PropertyType

Tipi di risorse delle proprietà.

Enum
PROPERTY_TYPE_UNSPECIFIED Tipo di proprietà sconosciuto o non specificato
PROPERTY_TYPE_ORDINARY Proprietà GA4 ordinaria
PROPERTY_TYPE_SUBPROPERTY Proprietà secondaria GA4
PROPERTY_TYPE_ROLLUP Proprietà di aggregazione GA4

ProvisionAccountTicketRequest

Messaggio di richiesta per ProvisioningAccountTicket RPC.

Campi
account

Account

L'account da creare.
redirect_uri

string

URI di reindirizzamento a cui verrà indirizzato l'utente dopo aver accettato i Termini di servizio. Deve essere configurato nella console Cloud come URI di reindirizzamento.

ProvisionAccountTicketResponse

Messaggio di risposta per ProvisioningAccountTicket RPC.

Campi
account_ticket_id

string

Il parametro da passare nel link TdS.

RunAccessReportRequest

La richiesta di un report del record di accesso ai dati.

Campi
entity

string

Il report di accesso ai dati supporta le richieste a livello di proprietà o account. Se richiesto a livello di account, i report di accesso ai dati includono tutti gli accessi a tutte le proprietà di quell'account.

Per eseguire la richiesta a livello di proprietà, l'entità deve essere, ad esempio, "properties/123" se "123" è il tuo ID proprietà GA4. Per eseguire la richiesta a livello di account, l'entità deve essere, ad esempio, "accounts/1234" se "1234" è il tuo ID account GA4.
dimensions[]

AccessDimension

Le dimensioni richieste e visualizzate nella risposta. Nelle richieste sono consentite fino a 9 dimensioni.
metrics[]

AccessMetric

Le metriche richieste e visualizzate nella risposta. Nelle richieste sono consentite fino a 10 metriche.
date_ranges[]

AccessDateRange

Intervalli di date dei record di accesso da leggere. Se vengono richiesti più intervalli di date, ogni riga di risposta conterrà un indice dell'intervallo di date basato su zero. Se due intervalli di date si sovrappongono, i record di accesso per i giorni sovrapposti vengono inclusi nelle righe di risposta per entrambi gli intervalli. Le richieste sono consentite fino a 2 intervalli di date.
dimension_filter

AccessFilterExpression

I filtri delle dimensioni consentono di limitare le risposte del report a valori di dimensione specifici corrispondenti al filtro. Ad esempio, filtrando in base ai record di accesso di un singolo utente. Per scoprire di più, consulta la sezione Nozioni di base sui filtri delle dimensioni per alcuni esempi. Impossibile utilizzare metriche in questo filtro.
metric_filter

AccessFilterExpression

I filtri delle metriche ti consentono di limitare le risposte del report a valori specifici delle metriche corrispondenti al filtro. I filtri delle metriche vengono applicati dopo l'aggregazione delle righe del report, in modo simile alla clausola SQL. Impossibile utilizzare le dimensioni in questo filtro.
offset

int64

Il conteggio delle righe della riga iniziale. La prima riga viene conteggiata come riga 0. Se l'offset non è specificato, viene considerato come 0. Se l'offset è pari a zero, questo metodo restituirà la prima pagina dei risultati con voci limit.

Per scoprire di più su questo parametro di impaginazione, consulta Impaginazione.
limit

int64

Il numero di righe da restituire. Se non specificati, vengono restituite 10.000 righe. L'API restituisce un massimo di 100.000 righe per richiesta, indipendentemente da quante ne chiedi. limit deve essere un numero positivo.

L'API potrebbe restituire meno righe rispetto al valore limit richiesto, se il numero di righe rimanente è inferiore a quello di limit. Ad esempio, sono disponibili meno di 300 valori possibili per la dimensione country, di conseguenza quando generi report solo su country, non puoi ottenere più di 300 righe, anche se imposti limit su un valore più alto.

Per scoprire di più su questo parametro di impaginazione, consulta Impaginazione.
time_zone

string

Fuso orario di questa richiesta, se specificato. Se non specificato, viene utilizzato il fuso orario della proprietà. Il fuso orario della richiesta viene utilizzato per interpretare le date di inizio e fine del report.

Formattate come stringhe dal database del fuso orario IANA (https://www.iana.org/time-zones); ad esempio "America/New_York" o "Asia/Tokyo".
order_bys[]

AccessOrderBy

Specifica in che modo vengono ordinate le righe nella risposta.
return_entity_quota

bool

Consente di attivare/disattivare la restituzione dello stato corrente della quota di questa proprietà Analytics. La quota viene restituita in AccessQuota. Per le richieste a livello di account, questo campo deve essere false.
include_all_users

bool

Campo facoltativo. Consente di stabilire se includere nella risposta gli utenti che non hanno mai effettuato una chiamata API. Se il valore è true, tutti gli utenti con accesso alla proprietà o all'account specificati vengono inclusi nella risposta, indipendentemente dal fatto che abbiano effettuato o meno una chiamata API. Se il valore è false, vengono inclusi solo gli utenti che hanno effettuato una chiamata API.
expand_groups

bool

Campo facoltativo. Decide se restituire gli utenti all'interno dei gruppi di utenti. Questo campo funziona solo quando include_all_users è impostato su true. Se il valore è true, verranno restituiti tutti gli utenti con accesso alla proprietà o all'account specificati. Se il valore è false, verranno restituiti solo gli utenti con accesso diretto.

RunAccessReportResponse

La risposta personalizzata del report del record di accesso ai dati.

Campi
dimension_headers[]

AccessDimensionHeader

L'intestazione di una colonna del report che corrisponde a una dimensione specifica. Il numero di QuoteHeader e l'ordine di QuoteHeaders corrisponde alle dimensioni presenti nelle righe.
metric_headers[]

AccessMetricHeader

L'intestazione di una colonna del report che corrisponde a una metrica specifica. Il numero di MetricHeaders e l'ordine di MetricHeaders corrisponde alle metriche presenti nelle righe.
rows[]

AccessRow

Righe di combinazioni di valori di dimensioni e valori delle metriche nel report.
row_count

int32

Il numero totale di righe nel risultato della query. rowCount è indipendente dal numero di righe restituite nella risposta, dal parametro di richiesta limit e dal parametro di richiesta offset. Ad esempio, se una query restituisce 175 righe e include limit di 50 nella richiesta API, la risposta conterrà rowCount di 175 ma solo 50 righe.

Per scoprire di più su questo parametro di impaginazione, consulta Impaginazione.
quota

AccessQuota

Lo stato della quota per questa proprietà Analytics, inclusa questa richiesta. Questo campo non funziona con le richieste a livello di account.

SearchChangeHistoryEventsRequest

Messaggio di richiesta per RPC SearchChange HistoryEvents.

Campi
account

string

Obbligatoria. La risorsa dell'account per la quale restituire le risorse di cronologia delle modifiche. Formato: accounts/{account}. Esempio: "accounts/100"
property

string

Campo facoltativo. Nome risorsa per una proprietà secondaria. Se impostato, restituisci solo le modifiche apportate a questa proprietà o alle relative risorse figlio. Formato: Properties/{propertyId} Esempio: "properties/100"
resource_type[]

ChangeHistoryResourceType

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

ActionType

Campo facoltativo. Se impostato, restituisci solo le modifiche che corrispondono a uno o più di questi tipi di azioni.
actor_email[]

string

Campo facoltativo. Se impostato, restituisci solo le modifiche apportate da un utente incluso in questo elenco.
earliest_change_time

Timestamp

Campo facoltativo. Se impostato, restituisci solo le modifiche apportate dopo questo periodo di tempo (incluso).
latest_change_time

Timestamp

Campo facoltativo. Se impostato, restituisci solo le modifiche apportate prima di questo orario (incluso).
page_size

int32

Campo facoltativo. Il numero massimo di elementi Change HistoryEvent da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore, anche se sono presenti pagine aggiuntive. Se non specificati, verranno restituiti al massimo 50 elementi. Il valore massimo è 200 (i valori più elevati verranno costretti a raggiungere il massimo).
page_token

string

Campo facoltativo. Un token di pagina, ricevuto da una chiamata SearchChangeHistoryEvents precedente. Specifica questo valore 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.

SearchChangeHistoryEventsResponse

Messaggio di risposta per SearchAccounts RPC.

Campi
change_history_events[]

ChangeHistoryEvent

Risultati accessibili per il chiamante.
next_page_token

string

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

ServiceLevel

Vari livelli di servizio per Google Analytics.

Enum
SERVICE_LEVEL_UNSPECIFIED Livello di servizio non specificato o non valido.
GOOGLE_ANALYTICS_STANDARD La versione standard di Google Analytics.
GOOGLE_ANALYTICS_360 La versione premium a pagamento di Google Analytics.

UpdateAccountRequest

Messaggio di richiesta per RPC UpdateAccount.

Campi
account

Account

Obbligatoria. L'account da aggiornare. Il campo name dell'account viene utilizzato per identificare l'account.
update_mask

FieldMask

Obbligatoria. L'elenco dei campi da aggiornare. I nomi dei campi devono essere scritti con lettere maiuscole e minuscole (ad esempio, "field_to_update"). I campi omessi non verranno aggiornati. Per sostituire l'intera entità, utilizza un percorso con la stringa "*" per trovare corrispondenze di tutti i campi.

UpdateConversionEventRequest

Messaggio di richiesta per RPC UpdateConversionEvent

Campi
conversion_event

ConversionEvent

Obbligatoria. L'evento di conversione da aggiornare. Il campo name viene utilizzato per identificare le impostazioni da aggiornare.
update_mask

FieldMask

Obbligatoria. L'elenco dei campi da aggiornare. I nomi dei campi devono essere in maiuscolo (ad es. "field_to_update"). I campi omessi non verranno aggiornati. Per sostituire l'intera entità, utilizza un percorso con la stringa "*" per trovare corrispondenze di tutti i campi.

UpdateCustomDimensionRequest

Messaggio di richiesta per RPC UpdateCustomSize.

Campi
custom_dimension

CustomDimension

La dimensione personalizzata da aggiornare
update_mask

FieldMask

Obbligatoria. L'elenco dei campi da aggiornare. I campi omessi non verranno aggiornati. Per sostituire l'intera entità, utilizza un percorso con la stringa "*" per trovare corrispondenze di tutti i campi.

UpdateCustomMetricRequest

Messaggio di richiesta per RPC UpdateCustomMetric.

Campi
custom_metric

CustomMetric

La metrica personalizzata da aggiornare
update_mask

FieldMask

Obbligatoria. L'elenco dei campi da aggiornare. I campi omessi non verranno aggiornati. Per sostituire l'intera entità, utilizza un percorso con la stringa "*" per trovare corrispondenze di tutti i campi.

UpdateDataRetentionSettingsRequest

Messaggio di richiesta per RPC UpdateDataFidelizzazioneSettings.

Campi
data_retention_settings

DataRetentionSettings

Obbligatoria. Le impostazioni da aggiornare. Il campo name viene utilizzato per identificare le impostazioni da aggiornare.
update_mask

FieldMask

Obbligatoria. L'elenco dei campi da aggiornare. I nomi dei campi devono essere in maiuscolo (ad es. "field_to_update"). I campi omessi non verranno aggiornati. Per sostituire l'intera entità, utilizza un percorso con la stringa "*" per trovare corrispondenze di tutti i campi.

UpdateDataStreamRequest

Messaggio di richiesta per RPC UpdateDataStream.

Campi
data_stream

DataStream

DataStream da aggiornare
update_mask

FieldMask

Obbligatoria. L'elenco dei campi da aggiornare. I campi omessi non verranno aggiornati. Per sostituire l'intera entità, utilizza un percorso con la stringa "*" per trovare corrispondenze di tutti i campi.

UpdateGoogleAdsLinkRequest

Messaggio di richiesta per UpdateGoogleAdsLink RPC

Campi
update_mask

FieldMask

Obbligatoria. L'elenco dei campi da aggiornare. I nomi dei campi devono essere in maiuscolo (ad es. "field_to_update"). I campi omessi non verranno aggiornati. Per sostituire l'intera entità, utilizza un percorso con la stringa "*" per trovare corrispondenze di tutti i campi.

UpdateKeyEventRequest

Messaggio di richiesta per RPC UpdateKeyEvent

Campi
key_event

KeyEvent

Obbligatoria. L'evento chiave da aggiornare. Il campo name viene utilizzato per identificare le impostazioni da aggiornare.
update_mask

FieldMask

Obbligatoria. L'elenco dei campi da aggiornare. I nomi dei campi devono essere in maiuscolo (ad es. "field_to_update"). I campi omessi non verranno aggiornati. Per sostituire l'intera entità, utilizza un percorso con la stringa "*" per trovare corrispondenze di tutti i campi.

UpdateMeasurementProtocolSecretRequest

Messaggio di richiesta per RPC UpdateMeasurementProtocolSecret

Campi
measurement_protocol_secret

MeasurementProtocolSecret

Obbligatoria. Il secret di Measurement Protocol da aggiornare.
update_mask

FieldMask

Obbligatoria. L'elenco dei campi da aggiornare. I campi omessi non verranno aggiornati.

UpdatePropertyRequest

Messaggio di richiesta per UpdateProperty RPC.

Campi
property

Property

Obbligatoria. La proprietà da aggiornare. Il campo name della proprietà viene utilizzato per identificare la proprietà da aggiornare.
update_mask

FieldMask

Obbligatoria. L'elenco dei campi da aggiornare. I nomi dei campi devono essere in maiuscolo (ad es. "field_to_update"). I campi omessi non verranno aggiornati. Per sostituire l'intera entità, utilizza un percorso con la stringa "*" per trovare corrispondenze di tutti i campi.