Package google.analytics.admin.v1beta

Indice

AnalyticsAdminService

Interfaccia di servizio per l'API Google Analytics Admin.

AcknowledgeUserDataCollection

rpc AcknowledgeUserDataCollection(AcknowledgeUserDataCollectionRequest) returns (AcknowledgeUserDataCollectionResponse)

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

Questo riconoscimento deve essere completato (nell'interfaccia utente di Google Analytics o tramite questa API) prima che sia possibile creare le 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 in 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 in una proprietà.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc CreateConversionEvent(CreateConversionEventRequest) returns (ConversionEvent)

Deprecato: utilizza CreateKeyEvent. 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 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à Google Analytics con la posizione 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)

Contrassegni l'account di destinazione come eliminato in modo non definitivo (ad es. "Trasferito nel cestino") e lo restituisce.

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

Se gli account non vengono ripristinati prima della data di scadenza, l'account e tutte le risorse secondarie (ad es. proprietà, link Google Ads, stream, associazioni di accesso) verranno eliminati definitivamente. 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)

Deprecato: utilizza DeleteKeyEvent. Consente di eliminare 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)

Consente di eliminare uno stream di dati in una proprietà.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc DeleteKeyEvent(DeleteKeyEventRequest) returns (Empty)

Consente di eliminare un evento chiave.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc DeleteMeasurementProtocolSecret(DeleteMeasurementProtocolSecretRequest) returns (Empty)

Consente di eliminare il MeasurementProtocolSecret di destinazione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc DeleteProperty(DeletePropertyRequest) returns (Property)

Contrassegni la proprietà target come eliminata temporaneamente (ad es. "Trasferita nel 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 data di scadenza, la proprietà e tutte le risorse secondarie (ad es. GoogleAdsLinks, stream, AccessBindings) verranno eliminate definitivamente. 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
GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

Cerca 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)

Deprecato: utilizza GetKeyEvent. 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 univoche 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)

Ottenere le impostazioni di condivisione dei dati in un account. Le impostazioni di condivisione dei dati sono univoche.

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)

Cerca 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)

Cerca un singolo MeasurementProtocolSecret.

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à GA.

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à GA. Gli account eliminati temporaneamente (ad es. "trasferiti 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)

Deprecato: utilizza ListKeyEvents. 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 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
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 gli stream di dati 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 i MeasurementProtocolSecrets secondari nella 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 nell'account principale specificato.

Le proprietà verranno escluse se l'utente che chiama non dispone dell'accesso. Le proprietà eliminate temporaneamente (ad es. "trasferite nel cestino") sono escluse per impostazione predefinita. Restituisce un elenco vuoto se non vengono trovate 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 i record di ogni volta che un utente legge i dati dei report di Google Analytics. I record di accesso vengono conservati per un massimo di 2 anni.

I report di accesso ai dati possono essere richiesti 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 di accesso ai dati includono i report della UI di GA, le esplorazioni della UI di GA, l'API GA Data 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.

Per inviare il tuo feedback su questa API, compila il modulo Feedback sui report di accesso di Google Analytics.

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 suoi elementi secondari in base all'insieme di filtri specificato.

Restituisce solo il sottoinsieme di modifiche supportate dall'API. L'interfaccia utente potrebbe restituire ulteriori modifiche.

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)

Deprecato: utilizza UpdateKeyEvent. 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 in 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 in 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 univoci 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 in 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

Per indicare 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 della query nel formato YYYY-MM-DD. Non può essere successiva al giorno endDate. Sono accettati anche i formati 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 inclusiva della query nel formato YYYY-MM-DD. Non può essere antecedente al giorno startDate. Sono accettati anche i formati 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'indirizzo email dell'utente che ha avuto accesso ai dati dei report. I valori delle dimensioni nelle risposte ai report sono stringhe.

Campi
dimension_name

string

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

I riferimenti alle dimensioni vengono indicati per nome in dimensionFilter e orderBys.

AccessDimensionHeader

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

Campi
dimension_name

string

Il nome della dimensione, ad esempio "userEmail".

AccessDimensionValue

Il valore di una dimensione.

Campi
value

string

Il valore della dimensione. Ad esempio, questo valore potrebbe 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 unione one_filter. Specifica un tipo di filtro per Filter. one_filter può essere solo uno dei seguenti:
string_filter

AccessStringFilter

Filtro relativo alle stringhe.

in_list_filter

AccessInListFilter

Un filtro per i valori dell'elenco in.

numeric_filter

AccessNumericFilter

Un filtro per 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 unione one_expression. Specifica un tipo di espressione di filtro per FilterExpression. one_expression può essere solo uno dei seguenti:
and_group

AccessFilterExpressionList

Ognuna delle espressioni FilterExpression in and_group ha una relazione AND.

or_group

AccessFilterExpressionList

Ognuna delle espressioni filtro in or_group ha una relazione OR.

not_expression

AccessFilterExpression

L'espressione di filtro NON è di tipo not_expression.

access_filter

AccessFilter

Un filtro primitivo. Nella stessa FilterExpression, 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 in un elenco di valori di stringa.

Campi
values[]

string

L'elenco dei valori di stringa. 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 indica il numero totale di record di accesso ai dati.

Campi
metric_name

string

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

I riferimenti alle metriche vengono visualizzati per nome in metricFilter e orderBys.

AccessMetricHeader

Descrive una colonna delle 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 generano colonne in un report; di conseguenza, queste metriche non generano intestazioni.

Campi
metric_name

string

Il nome della metrica, ad esempio "accessCount".

AccessMetricValue

Il valore di una metrica.

Campi
value

string

Il valore della misurazione. Ad esempio, questo valore potrebbe 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 una 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 criteri di ordinamento definiscono il modo in cui le righe verranno ordinate nella risposta. Ad esempio, ordinare le righe in base al numero di accessi in ordine decrescente è un tipo di ordinamento, mentre ordinare le righe in base alla stringa del paese è un altro tipo di ordinamento.

Campi
desc

bool

Se true, ordina in ordine decrescente. Se è false o non specificato, l'ordinamento avviene in ordine crescente.

Campo unione one_order_by. Specifica un tipo di ordinamento 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

Il nome di una dimensione nella richiesta in base alla quale effettuare l'ordinamento.

order_type

OrderType

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

OrderType

Regola in base alla quale ordinare i valori della dimensione stringa.

Enum
ORDER_TYPE_UNSPECIFIED Non specificato.
ALPHANUMERIC Ordinamento alfanumerico in base al punto di codice Unicode. Ad esempio, "2" < "A" < "X" < "b" < "z".
CASE_INSENSITIVE_ALPHANUMERIC Ordinamento alfanumerico senza distinzione tra maiuscole e minuscole in base al 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 delle dimensioni non numeriche 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 alla quale ordinare.

AccessQuota

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

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 consuma un singolo numero di token, che viene detratto da tutte le quote orarie, giornaliere e orarie 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 progetti cloud possono avere fino a 50 errori del server all'ora.

tokens_per_project_per_hour

AccessQuotaStatus

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

AccessQuotaStatus

Stato attuale di un determinato gruppo di quote.

Campi
consumed

int32

Quota consumata da questa richiesta.

remaining

int32

Quota rimanente dopo questa richiesta.

AccessRow

Accedi ai dati dei report per ogni riga.

Campi
dimension_values[]

AccessDimensionValue

Elenco di valori delle dimensioni. Questi valori sono nello stesso ordine specificato nella richiesta.

metric_values[]

AccessMetricValue

Elenco di 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 di 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 della stringa.
ENDS_WITH Termina con il valore della stringa.
CONTAINS Contiene il valore della stringa.
FULL_REGEXP Corrispondenza completa per l'espressione regolare con il valore della stringa.
PARTIAL_REGEXP Corrispondenza parziale per l'espressione regolare con il valore della stringa.

Account

Un messaggio della risorsa che rappresenta un account Google Analytics.

Campi
name

string

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

create_time

Timestamp

Solo output. Ora in cui è stato creato originariamente questo account.

update_time

Timestamp

Solo output. Ora dell'ultimo aggiornamento dei campi del payload dell'account.

display_name

string

Obbligatorio. Nome visualizzato leggibile per questo account.

region_code

string

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

deleted

bool

Solo output. Indica se questo account è stato eliminato definitivamente o meno. Gli account eliminati sono esclusi dai risultati dell'elenco, a meno che non sia stato richiesto esplicitamente.

gmp_organization

string

Solo output. L'URI per una risorsa dell'organizzazione 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à Google Analytics secondarie.

Campi
name

string

Nome della 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 dell'account a cui si fa riferimento in questo riepilogo.

property_summaries[]

PropertySummary

Elenco di riepiloghi per gli account secondari di questo account.

AcknowledgeUserDataCollectionRequest

Messaggio di richiesta per l'RPC AcknowledgeUserDataCollection.

Campi
property

string

Obbligatorio. La proprietà per cui accettare la raccolta dei dati utente.

acknowledgement

string

Obbligatorio. Un riconoscimento del fatto che chi chiama questo metodo comprende i termini della raccolta dei dati utente.

Questo campo deve contenere il valore esatto: "Dichiaro 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 l'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 in questa modifica.
UPDATED La risorsa è stata aggiornata in questa modifica.
DELETED La risorsa è stata eliminata in questa modifica.

ActorType

Diversi tipi di utenti 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 l'RPC ArchiveCustomDimension.

Campi
name

string

Obbligatorio. Il nome della dimensione personalizzata da archiviare. Formato di esempio: properties/1234/customDimensions/5678

ArchiveCustomMetricRequest

Messaggio di richiesta per l'RPC ArchiveCustomMetric.

Campi
name

string

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

ChangeHistoryChange

Una 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 della risorsa precedenti alla modifica. Se questa risorsa è stata creata in questa modifica, questo campo non sarà presente.

resource_after_change

ChangeHistoryResource

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

ChangeHistoryResource

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

Campi

Campo unione resource.

resource può essere solo uno dei seguenti:

account

Account

Uno snapshot di una risorsa Account nella cronologia delle modifiche.

property

Property

Uno snapshot di una risorsa Property nella cronologia delle modifiche.

conversion_event

ConversionEvent

Uno snapshot 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 di 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 all'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 della cronologia delle modifiche. Questo ID è univoco in Google Analytics.

change_time

Timestamp

Ora in cui è stata apportata la modifica.

actor_type

ActorType

Il tipo di attore che ha apportato questa modifica.

user_actor_email

string

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

changes_filtered

bool

Se è true, l'elenco delle modifiche restituite è stato filtrato e non rappresenta tutte le modifiche che si sono verificate in questo evento.

changes[]

ChangeHistoryChange

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

ChangeHistoryResourceType

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

Enum
CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED Tipo di risorsa sconosciuto o non specificato.
ACCOUNT Risorsa account
PROPERTY Risorsa proprietà
GOOGLE_SIGNALS_SETTINGS Risorsa GoogleSignalsSettings
CONVERSION_EVENT Risorsa ConversionEvent
MEASUREMENT_PROTOCOL_SECRET Risorsa MeasurementProtocolSecret
CUSTOM_DIMENSION Risorsa CustomDimension
CUSTOM_METRIC Risorsa CustomMetric
DATA_RETENTION_SETTINGS Risorsa DataRetentionSettings
DATA_STREAM Risorsa DataStream
ATTRIBUTION_SETTINGS Risorsa AttributionSettings

ConversionEvent

Un evento di conversione in una proprietà Google Analytics.

Campi
name

string

Solo output. Nome della risorsa di questo evento di conversione. Formato: properties/{property}/conversionEvents/{conversion_event}

event_name

string

Immutabile. Il nome dell'evento di conversione. Esempi: "click", "purchase"

create_time

Timestamp

Solo output. Data e ora in cui è stato creato questo evento di conversione nella proprietà.

deletable

bool

Solo output. Se impostato, questo evento può essere attualmente 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 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 per te dal sistema GA, ma in alcuni casi possono essere creati dagli amministratori della proprietà. Gli eventi personalizzati vengono conteggiati ai fini del numero massimo di eventi di conversione personalizzati che possono essere creati per proprietà.

counting_method

ConversionCountingMethod

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

default_conversion_value

DefaultConversionValue

Facoltativo. Definisce un valore/una valuta predefiniti per un evento di conversione.

ConversionCountingMethod

Il metodo con cui le conversioni verranno conteggiate in 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 e per utente.

DefaultConversionValue

Definisce un valore/una valuta predefiniti per un evento di conversione. È necessario specificare sia il valore sia la valuta.

Campi
value

double

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

currency_code

string

Quando un evento di conversione per questo 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.

CreateConversionEventRequest

Messaggio di richiesta per l'RPC CreateConversionEvent

Campi
conversion_event

ConversionEvent

Obbligatorio. L'evento di conversione da creare.

parent

string

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

CreateCustomDimensionRequest

Messaggio di richiesta per l'RPC CreateCustomDimension.

Campi
parent

string

Obbligatorio. Formato di esempio: properties/1234

custom_dimension

CustomDimension

Obbligatorio. La dimensione personalizzata da creare.

CreateCustomMetricRequest

Messaggio di richiesta per l'RPC CreateCustomMetric.

Campi
parent

string

Obbligatorio. Formato di esempio: properties/1234

custom_metric

CustomMetric

Obbligatorio. La metrica personalizzata da creare.

CreateDataStreamRequest

Messaggio di richiesta per l'RPC CreateDataStream.

Campi
parent

string

Obbligatorio. Formato di esempio: properties/1234

data_stream

DataStream

Obbligatorio. Lo stream di dati da creare.

CreateFirebaseLinkRequest

Messaggio di richiesta per l'RPC CreateFirebaseLink

Campi
parent

string

Obbligatorio. Formato: properties/{property_id}

Esempio: properties/1234

CreateGoogleAdsLinkRequest

Messaggio di richiesta per l'RPC CreateGoogleAdsLink

Campi
parent

string

Obbligatorio. Formato di esempio: properties/1234

CreateKeyEventRequest

Messaggio di richiesta per l'RPC CreateKeyEvent

Campi
key_event

KeyEvent

Obbligatorio. L'evento chiave da creare.

parent

string

Obbligatorio. Il nome della risorsa della proprietà principale in cui verrà creato questo evento chiave. Formato: properties/123

CreateMeasurementProtocolSecretRequest

Messaggio di richiesta per l'RPC CreateMeasurementProtocolSecret

Campi
parent

string

Obbligatorio. La risorsa principale in cui verrà creato questo secret. Formato: properties/{property}/dataStreams/{dataStream}

measurement_protocol_secret

MeasurementProtocolSecret

Obbligatorio. L'API secret Measurement Protocol da creare.

CreatePropertyRequest

Messaggio di richiesta per l'RPC CreateProperty.

Campi
property

Property

Obbligatorio. La proprietà da creare. Nota: la proprietà fornita deve specificare il relativo elemento principale.

CustomDimension

Una definizione per una dimensione personalizzata.

Campi
name

string

Solo output. Nome della risorsa CustomDimension. Formato: properties/{property}/customDimensions/{customDimension}

parameter_name

string

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

Se si tratta di una dimensione basata sugli utenti, questo è il nome della proprietà utente. Se si tratta di una dimensione basata sugli eventi, si tratta del nome del parametro evento.

Se si tratta di una dimensione basata sugli articoli, si tratta del nome del parametro trovato nell'array di articoli di e-commerce.

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

display_name

string

Obbligatorio. Nome visualizzato per questa dimensione personalizzata, come mostrato nell'interfaccia utente di Analytics. Lunghezza massima di 82 caratteri, alfanumerici più spazio e trattino basso che inizia con una lettera. I nomi visualizzati generati dal sistema precedente possono contenere parentesi quadre, ma gli aggiornamenti di questo campo non le consentiranno mai.

description

string

Facoltativo. Descrizione di questa dimensione personalizzata. Lunghezza massima di 150 caratteri.

scope

DimensionScope

Obbligatorio. Immutabile. L'ambito di questa dimensione.

disallow_ads_personalization

bool

Facoltativo. Se impostato su true, imposta questa dimensione come ANP ed escludendola dalla personalizzazione degli annunci.

Al momento, questa opzione è supportata solo dalle 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 basata su un evento.
USER Dimensione basata su un utente.
ITEM Dimensione basata sugli articoli di e-commerce

CustomMetric

Una definizione per una metrica personalizzata.

Campi
name

string

Solo output. Nome della risorsa per questa risorsa CustomMetric. Formato: properties/{property}/customMetrics/{customMetric}

parameter_name

string

Obbligatorio. 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, iniziando con una lettera. Lunghezza massima di 40 caratteri per le metriche basate sugli eventi.

display_name

string

Obbligatorio. Nome visualizzato per questa metrica personalizzata, come mostrato nell'interfaccia utente di Analytics. Lunghezza massima di 82 caratteri, alfanumerici più spazio e trattino basso che inizia con una lettera. I nomi visualizzati generati dal sistema precedente possono contenere parentesi quadre, ma gli aggiornamenti di questo campo non le consentiranno mai.

description

string

Facoltativo. Descrizione di questa dimensione personalizzata. Lunghezza massima di 150 caratteri.

measurement_unit

MeasurementUnit

Obbligatorio. Il tipo del valore della metrica personalizzata.

scope

MetricScope

Obbligatorio. Immutabile. L'ambito di questa metrica personalizzata.

restricted_metric_type[]

RestrictedMetricType

Facoltativo. Tipi di dati soggetti a limitazioni che questa metrica potrebbe contenere. Obbligatorio per le metriche con unità di misura MONETA. Deve essere vuoto per le metriche con un'unità di misura diversa da MONETA.

MeasurementUnit

Possibili tipi di rappresentazione del valore della metrica personalizzata.

La rappresentazione della valuta potrebbe cambiare in futuro, il che richiederà una modifica non compatibile dell'API.

Enum
MEASUREMENT_UNIT_UNSPECIFIED MeasurementUnit non specificato o mancante.
STANDARD Questa metrica utilizza le unità predefinite.
CURRENCY Questa metrica misura una valuta.
FEET Questa metrica misura i piedi.
METERS Questa metrica misura i metri.
KILOMETERS Questa metrica misura i chilometri.
MILES Questa metrica misura i chilometri.
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 basata su un evento.

RestrictedMetricType

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

Enum
RESTRICTED_METRIC_TYPE_UNSPECIFIED Tipo sconosciuto o non specificato.
COST_DATA La metrica registra i dati sui costi.
REVENUE_DATA La metrica registra i dati sulle entrate.

DataRetentionSettings

Valori delle impostazioni per la conservazione dei dati. Si tratta di una risorsa singleton.

Campi
name

string

Solo output. Nome della risorsa per questa risorsa DataRetentionSetting. Formato: properties/{property}/dataRetentionSettings

event_data_retention

RetentionDuration

Obbligatorio. La durata della conservazione dei dati a livello di evento.

user_data_retention

RetentionDuration

Obbligatorio. La durata della conservazione dei dati a livello di utente.

reset_user_data_on_new_activity

bool

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

RetentionDuration

Valori validi per la durata della conservazione dei dati.

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

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 ai rappresentanti dell'assistenza tecnica di Google di accedere ai tuoi dati e al tuo account Google Analytics, se necessario, per fornire assistenza e trovare soluzioni a problemi tecnici.

Questo campo corrisponde al campo "Assistenza tecnica" nell'interfaccia utente Amministrazione di Google Analytics.

sharing_with_google_assigned_sales_enabled

bool

Consente a Google di accedere ai dati del tuo account Google Analytics, inclusi i dati di configurazione e utilizzo dell'account, la spesa per i prodotti e gli utenti associati all'account Google Analytics, in modo che Google possa aiutarti a ottenere il massimo dai prodotti Google, fornendoti approfondimenti, offerte, consigli e suggerimenti per l'ottimizzazione su Google Analytics e in altri prodotti Google per le attività.

Questo campo corrisponde al campo "Consigli per la tua attività" nell'interfaccia utente Amministrazione di Google Analytics.

sharing_with_google_any_sales_enabled
(deprecated)

bool

Deprecato. Questo campo non è più utilizzato e restituisce sempre false.

sharing_with_google_products_enabled

bool

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

Questi campi corrispondono al campo "Prodotti e servizi Google " nell'interfaccia utente Amministrazione di Google Analytics.

sharing_with_others_enabled

bool

Attiva funzionalità come le previsioni, i dati modellati e il benchmarking che possono offrirti approfondimenti aziendali più completi quando fornisci dati di misurazione aggregati. I dati che condividi (incluse le informazioni sulla proprietà da cui vengono condivisi) vengono aggregati e anonimizzati prima di essere utilizzati per generare approfondimenti aziendali.

Questo campo corrisponde al campo "Contributi alla generazione di modelli e approfondimenti sull'attività" nell'interfaccia utente Amministrazione di Google Analytics.

DataStream

Un messaggio della risorsa che rappresenta uno stream di dati.

Campi
name

string

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

type

DataStreamType

Obbligatorio. 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 per il nome visualizzato è 255 unità di codice UTF-16.

create_time

Timestamp

Solo output. Ora in cui è stato creato originariamente lo stream.

update_time

Timestamp

Solo output. Ora dell'ultimo aggiornamento dei campi del payload dello stream.

Campo unione stream_data. Dati per tipi specifici di stream di dati. Il messaggio che verrà impostato corrisponde al tipo di questo stream. 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 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 esistente. Questo ID può cambiare se l'app per iOS viene eliminata e ricreata.

bundle_id

string

Obbligatorio. 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 misurata o vuoto. Esempio: "http://www.google.com", "https://www.google.com"

DeleteAccountRequest

Messaggio di richiesta per l'RPC DeleteAccount.

Campi
name

string

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

DeleteConversionEventRequest

Messaggio di richiesta per l'RPC DeleteConversionEvent

Campi
name

string

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

DeleteDataStreamRequest

Messaggio di richiesta per l'RPC DeleteDataStream.

Campi
name

string

Obbligatorio. Il nome dello stream di dati da eliminare. Formato di esempio: properties/1234/dataStreams/5678

DeleteFirebaseLinkRequest

Messaggio di richiesta per l'RPC DeleteFirebaseLink

Campi
name

string

Obbligatorio. Formato: properties/{property_id}/firebaseLinks/{firebase_link_id}

Esempio: properties/1234/firebaseLinks/5678

DeleteGoogleAdsLinkRequest

Messaggio di richiesta per l'RPC DeleteGoogleAdsLink.

Campi
name

string

Obbligatorio. Formato di esempio: properties/1234/googleAdsLinks/5678

DeleteKeyEventRequest

Messaggio di richiesta per l'RPC DeleteKeyEvent

Campi
name

string

Obbligatorio. 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 l'RPC DeleteMeasurementProtocolSecret

Campi
name

string

Obbligatorio. Il nome del MeasurementProtocolSecret da eliminare. Formato: properties/{property}/dataStreams/{dataStream}/measurementProtocolSecrets/{measurementProtocolSecret}

DeletePropertyRequest

Messaggio di richiesta per l'RPC DeleteProperty.

Campi
name

string

Obbligatorio. Il nome della proprietà da eliminare definitivamente. Formato: properties/{property_id} Esempio: "properties/1000"

GetAccountRequest

Messaggio di richiesta per l'RPC GetAccount.

Campi
name

string

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

GetConversionEventRequest

Messaggio di richiesta per l'RPC GetConversionEvent

Campi
name

string

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

GetCustomDimensionRequest

Messaggio di richiesta per l'RPC GetCustomDimension.

Campi
name

string

Obbligatorio. Il nome della dimensione personalizzata da ottenere. Formato di esempio: properties/1234/customDimensions/5678

GetCustomMetricRequest

Messaggio di richiesta per l'RPC GetCustomMetric.

Campi
name

string

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

GetDataRetentionSettingsRequest

Messaggio di richiesta per l'RPC GetDataRetentionSettings.

Campi
name

string

Obbligatorio. Il nome delle impostazioni da cercare. Formato: properties/{property}/dataRetentionSettings Esempio: "properties/1000/dataRetentionSettings"

GetDataSharingSettingsRequest

Messaggio di richiesta per l'RPC GetDataSharingSettings.

Campi
name

string

Obbligatorio. Il nome delle impostazioni da cercare. Formato: accounts/{account}/dataSharingSettings

Esempio: accounts/1000/dataSharingSettings

GetDataStreamRequest

Messaggio di richiesta per l'RPC GetDataStream.

Campi
name

string

Obbligatorio. Il nome dello stream di dati da ottenere. Formato di esempio: properties/1234/dataStreams/5678

GetKeyEventRequest

Messaggio di richiesta per l'RPC GetKeyEvent

Campi
name

string

Obbligatorio. 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 l'RPC GetMeasurementProtocolSecret.

Campi
name

string

Obbligatorio. Il nome del secret Measurement Protocol da cercare. Formato: properties/{property}/dataStreams/{dataStream}/measurementProtocolSecrets/{measurementProtocolSecret}

GetPropertyRequest

Messaggio di richiesta per l'RPC GetProperty.

Campi
name

string

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

IndustryCategory

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

Enum
INDUSTRY_CATEGORY_UNSPECIFIED Categoria di 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 Videogiochi
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 Scienze
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 della risorsa di questo evento chiave. Formato: properties/{property}/keyEvents/{key_event}

event_name

string

Immutabile. Il nome dell'evento chiave. Esempi: "click", "purchase"

create_time

Timestamp

Solo output. 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 per te dal sistema GA, ma in alcuni casi possono essere creati dagli amministratori della proprietà. Gli eventi personalizzati vengono conteggiati ai fini del numero massimo di eventi chiave personalizzati che possono essere creati per proprietà.

counting_method

CountingMethod

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

default_value

DefaultValue

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

CountingMethod

Il metodo con cui gli eventi chiave verranno conteggiati in 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 viene considerata un evento chiave al massimo una volta per sessione e per utente.

DefaultValue

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

Campi
numeric_value

double

Obbligatorio. 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

Obbligatorio. Quando un'occorrenza di questo evento chiave (specificato da event_name) non ha una valuta impostata, 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.

ListAccountSummariesRequest

Messaggio di richiesta per l'RPC ListAccountSummaries.

Campi
page_size

int32

Il numero massimo di risorse AccountSummary da restituire. Il servizio potrebbe restituire meno di questo valore, anche se sono presenti pagine aggiuntive. Se non specificato, verranno restituite al massimo 50 risorse. Il valore massimo è 200; i valori superiori verranno forzati al massimo

page_token

string

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

ListAccountSummariesResponse

Messaggio di risposta per l'RPC ListAccountSummaries.

Campi
account_summaries[]

AccountSummary

Riepiloghi degli account a cui ha accesso chi chiama.

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 l'RPC ListAccounts.

Campi
page_size

int32

Il numero massimo di risorse da restituire. Il servizio potrebbe restituire meno di questo valore, anche se sono presenti pagine aggiuntive. Se non specificato, verranno restituite al massimo 50 risorse. Il valore massimo è 200; i valori superiori verranno forzati al massimo

page_token

string

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

show_deleted

bool

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

ListAccountsResponse

Messaggio di richiesta per l'RPC ListAccounts.

Campi
accounts[]

Account

Risultati 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.

ListConversionEventsRequest

Messaggio di richiesta per l'RPC ListConversionEvents

Campi
parent

string

Obbligatorio. Il nome della risorsa della proprietà principale. Esempio: "properties/123"

page_size

int32

Il numero massimo di risorse da restituire. Se non specificato, verranno restituite al massimo 50 risorse. Il valore massimo è 200; i valori superiori verranno forzati al massimo

page_token

string

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

ListConversionEventsResponse

Messaggio di risposta per l'RPC ListConversionEvents.

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 l'RPC ListCustomDimensions.

Campi
parent

string

Obbligatorio. Formato di esempio: properties/1234

page_size

int32

Il numero massimo di risorse da restituire. Se non specificato, verranno restituite al massimo 50 risorse. Il valore massimo è 200 (i valori superiori verranno forzati al massimo).

page_token

string

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

Quando viene applicata la paginazione, tutti gli altri parametri forniti a ListCustomDimensions devono corrispondere alla chiamata che ha fornito il token pagina.

ListCustomDimensionsResponse

Messaggio di risposta per l'RPC ListCustomDimensions.

Campi
custom_dimensions[]

CustomDimension

Elenco di CustomDimensions.

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 l'RPC ListCustomMetrics.

Campi
parent

string

Obbligatorio. Formato di esempio: properties/1234

page_size

int32

Il numero massimo di risorse da restituire. Se non specificato, verranno restituite al massimo 50 risorse. Il valore massimo è 200 (i valori superiori verranno forzati al massimo).

page_token

string

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

Quando viene applicata la paginazione, tutti gli altri parametri forniti a ListCustomMetrics devono corrispondere alla chiamata che ha fornito il token pagina.

ListCustomMetricsResponse

Messaggio di risposta per l'RPC ListCustomMetrics.

Campi
custom_metrics[]

CustomMetric

Elenco di CustomMetric.

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 l'RPC ListDataStreams.

Campi
parent

string

Obbligatorio. Formato di esempio: properties/1234

page_size

int32

Il numero massimo di risorse da restituire. Se non specificato, verranno restituite al massimo 50 risorse. Il valore massimo è 200 (i valori superiori verranno forzati al massimo).

page_token

string

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

Quando viene applicata la paginazione, tutti gli altri parametri forniti a ListDataStreams devono corrispondere alla chiamata che ha fornito il token pagina.

ListDataStreamsResponse

Messaggio di risposta per l'RPC ListDataStreams.

Campi
data_streams[]

DataStream

Elenco di stream di dati.

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 l'RPC ListFirebaseLinks

Campi
parent

string

Obbligatorio. Formato: properties/{property_id}

Esempio: properties/1234

page_size

int32

Il numero massimo di risorse da restituire. Il servizio potrebbe restituire meno di questo valore, anche se sono presenti pagine aggiuntive. Se non specificato, verranno restituite al massimo 50 risorse. Il valore massimo è 200; i valori superiori verranno forzati al massimo

page_token

string

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

ListFirebaseLinksResponse

Messaggio di risposta per l'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. Al momento, Google Analytics supporta un solo FirebaseLink per proprietà, pertanto questo campo non verrà mai compilato.

ListGoogleAdsLinksRequest

Messaggio di richiesta per l'RPC ListGoogleAdsLinks.

Campi
parent

string

Obbligatorio. Formato di esempio: properties/1234

page_size

int32

Il numero massimo di risorse da restituire. Se non specificato, verranno restituite al massimo 50 risorse. Il valore massimo è 200 (i valori superiori verranno forzati al massimo).

page_token

string

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

Quando viene applicata la paginazione, tutti gli altri parametri forniti a ListGoogleAdsLinks devono corrispondere alla chiamata che ha fornito il token pagina.

ListGoogleAdsLinksResponse

Messaggio di risposta per l'RPC ListGoogleAdsLinks.

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 l'RPC ListKeyEvents

Campi
parent

string

Obbligatorio. Il nome della risorsa della proprietà principale. Esempio: "properties/123"

page_size

int32

Il numero massimo di risorse da restituire. Se non specificato, verranno restituite al massimo 50 risorse. Il valore massimo è 200; i valori superiori verranno forzati al massimo

page_token

string

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

ListKeyEventsResponse

Messaggio di risposta per l'RPC ListKeyEvents.

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 l'RPC ListMeasurementProtocolSecret

Campi
parent

string

Obbligatorio. Il nome della risorsa dello stream principale. Formato: properties/{property}/dataStreams/{dataStream}/measurementProtocolSecrets

page_size

int32

Il numero massimo di risorse da restituire. Se non specificato, verranno restituite al massimo 10 risorse. Il valore massimo è 10. I valori più elevati verranno forzati al massimo.

page_token

string

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

ListMeasurementProtocolSecretsResponse

Messaggio di risposta per l'RPC ListMeasurementProtocolSecret

Campi
measurement_protocol_secrets[]

MeasurementProtocolSecret

Un elenco di secret per lo stream 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 l'RPC ListProperties.

Campi
filter

string

Obbligatorio. Un'espressione per filtrare i risultati della richiesta. I campi idonei per il filtro sono: parent:(il nome della risorsa dell'account/della proprietà principale) o ancestor:(il nome della risorsa dell'account principale) o firebase_project:(l'ID o il numero del progetto Firebase collegato). Ecco 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 meno di questo valore, anche se sono presenti pagine aggiuntive. Se non specificato, verranno restituite al massimo 50 risorse. Il valore massimo è 200; i valori superiori verranno forzati al massimo

page_token

string

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

show_deleted

bool

Indica se includere o meno nei risultati le proprietà eliminate definitivamente (ad es. "trasferite nel cestino"). Le proprietà possono essere controllate per determinare se sono state eliminate o meno.

ListPropertiesResponse

Messaggio di risposta per l'RPC ListProperties.

Campi
properties[]

Property

Risultati corrispondenti ai criteri di filtro e accessibili all'utente che ha effettuato la chiamata.

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 segreto utilizzato per l'invio di hit a Measurement Protocol.

Campi
name

string

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

display_name

string

Obbligatorio. Nome visualizzato leggibile per questo secret.

secret_value

string

Solo output. Il valore dell'API secret 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 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à Google Analytics.

Campi
name

string

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

property_type

PropertyType

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

create_time

Timestamp

Solo output. Ora in cui l'entità è stata creata originariamente.

update_time

Timestamp

Solo output. Ora dell'ultimo aggiornamento dei campi del payload dell'entità.

parent

string

Immutabile. Nome della risorsa del padre logico di questa proprietà.

Nota: l'interfaccia utente per lo spostamento delle proprietà può essere utilizzata per modificare la proprietà principale. Formato: accounts/{account}, properties/{property} Esempio: "accounts/100", "properties/101"

display_name

string

Obbligatorio. Nome visualizzato leggibile per questa proprietà.

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

industry_category

IndustryCategory

Esempio di settore associato a questa proprietà: AUTOMOTIVE, FOOD_AND_DRINK

time_zone

string

Obbligatorio. Fuso orario dei report, utilizzato come giorno limite per i report, indipendentemente dall'origine dei dati. Se il fuso orario osserva l'ora legale, Analytics si adegua automaticamente.

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 che includono 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 impostato, l'ora in cui questa proprietà è stata spostata nel cestino. Se non è impostata, questa proprietà non è attualmente nel cestino.

expire_time

Timestamp

Solo output. Se impostato, l'ora in cui questa proprietà eliminata verrà eliminata definitivamente. Se non è impostato, questa proprietà non è attualmente nel cestino e non è prevista la sua 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 di una proprietà Google Analytics.

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 si fa riferimento in questo riepilogo.

property_type

PropertyType

Il tipo di proprietà.

parent

string

Nome della risorsa del padre logico di questa proprietà.

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

PropertyType

Tipi di risorse Property.

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

ProvisionAccountTicketRequest

Messaggio di richiesta per l'RPC ProvisionAccountTicket.

Campi
account

Account

L'account da creare.

redirect_uri

string

URI di reindirizzamento a cui verrà inviato l'utente dopo aver accettato i Termini di servizio. Deve essere configurato in Cloud Console come URI di reindirizzamento.

ProvisionAccountTicketResponse

Messaggio di risposta per l'RPC ProvisionAccountTicket.

Campi
account_ticket_id

string

Il parametro da passare nel link ai TdS.

RunAccessReportRequest

La richiesta di un report Record di accesso ai dati.

Campi
entity

string

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

Per effettuare la richiesta a livello di proprietà, l'entità deve essere, ad esempio, "properties/123" se "123" è l'ID proprietà Google Analytics. Per effettuare la richiesta a livello di account, l'entità deve essere, ad esempio, "accounts/1234" se "1234" è l'ID account Google Analytics.

dimensions[]

AccessDimension

Le dimensioni richieste e visualizzate nella risposta. Le richieste possono contenere fino a nove dimensioni.

metrics[]

AccessMetric

Le metriche richieste e visualizzate nella risposta. Le richieste possono contenere 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 di intervallo di date basato su zero. Se due intervalli di date si sovrappongono, i record di accesso per i giorni in cui si sovrappongono sono inclusi nelle righe di risposta per entrambi gli intervalli di date. Le richieste sono consentite per un massimo di 2 intervalli di date.

dimension_filter

AccessFilterExpression

I filtri delle dimensioni ti consentono di limitare la risposta del report a valori specifici delle dimensioni che corrispondono al filtro. Ad esempio, filtrare in base ai record di accesso di un singolo utente. Per scoprire di più, consulta Nozioni di base sui filtri delle dimensioni per alcuni esempi. Le metriche non possono essere utilizzate in questo filtro.

metric_filter

AccessFilterExpression

I filtri delle metriche ti consentono di limitare la risposta del report a valori specifici delle metriche che corrispondono al filtro. I filtri delle metriche vengono applicati dopo l'aggregazione delle righe del report, in modo simile alla clausola having di SQL. Le dimensioni non possono essere utilizzate 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 pari a 0. Se l'offset è zero, questo metodo restituirà la prima pagina di risultati con limit voci.

Per scoprire di più su questo parametro di paginazione, consulta la sezione Paginazione.

limit

int64

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

L'API potrebbe restituire meno righe rispetto al limit richiesto, se le righe rimanenti non sono pari a limit. Ad esempio, esistono meno di 300 valori possibili per la dimensione country, pertanto, quando generi report solo su country, non puoi ottenere più di 300 righe, anche se imposti country su un valore più alto.limit

Per scoprire di più su questo parametro di paginazione, consulta la sezione Paginazione.

time_zone

string

Il 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 di fine del report.

Formattate come stringhe del database dei fusi orari IANA (https://www.iana.org/time-zones); ad esempio "America/New_York" o "Asia/Tokyo".

order_bys[]

AccessOrderBy

Specifica l'ordinamento delle righe nella risposta.

return_entity_quota

bool

Attiva/disattiva 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

Facoltativo. Determina se includere nella risposta gli utenti che non hanno mai effettuato una chiamata API. Se true, tutti gli utenti con accesso alla proprietà o all'account specificato sono inclusi nella risposta, indipendentemente dal fatto che abbiano effettuato o meno una chiamata API. Se è false, verranno inclusi solo gli utenti che hanno effettuato una chiamata API.

expand_groups

bool

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

RunAccessReportResponse

La risposta personalizzata del report 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 DimensionHeaders e l'ordinamento di DimensionHeaders corrispondono alle dimensioni presenti nelle righe.

metric_headers[]

AccessMetricHeader

L'intestazione di una colonna del report che corrisponde a una metrica specifica. Il numero di intestazioni delle metriche e l'ordine delle intestazioni delle metriche corrispondono alle metriche presenti nelle righe.

rows[]

AccessRow

Righe di combinazioni di valori di dimensione e valori di 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 paginazione, consulta la sezione Paginazione.

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 l'RPC SearchChangeHistoryEvents.

Campi
account

string

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

Esempio: accounts/100

property

string

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

Esempio: properties/100

resource_type[]

ChangeHistoryResourceType

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

action[]

ActionType

Facoltativo. Se impostato, restituisce solo le modifiche corrispondenti a uno o più di questi tipi di azioni.

actor_email[]

string

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

earliest_change_time

Timestamp

Facoltativo. Se impostato, restituisce solo le modifiche apportate dopo questa ora (inclusa).

latest_change_time

Timestamp

Facoltativo. Se impostato, restituisce solo le modifiche apportate prima di questa ora (inclusa).

page_size

int32

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

Tieni presente che il servizio potrebbe restituire una pagina con meno elementi rispetto a quelli specificati da questo valore (potenzialmente anche zero) e che potrebbero esserci altre pagine. Se vuoi un determinato numero di elementi, dovrai continuare a richiedere pagine aggiuntive utilizzando page_token finché non avrai il numero necessario.

page_token

string

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

SearchChangeHistoryEventsResponse

Messaggio di risposta per l'RPC SearchAccounts.

Campi
change_history_events[]

ChangeHistoryEvent

Risultati 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.

ServiceLevel

Vari livelli di servizio per Google Analytics.

Enum
SERVICE_LEVEL_UNSPECIFIED Livello del 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 l'RPC UpdateAccount.

Campi
account

Account

Obbligatorio. L'account da aggiornare. Il campo name dell'account viene utilizzato per identificarlo.

update_mask

FieldMask

Obbligatorio. L'elenco dei campi da aggiornare. I nomi dei campi devono essere in minuscolo con le iniziali maiuscole (ad esempio "campo_da_aggiornare"). I campi omessi non verranno aggiornati. Per sostituire l'intera entità, utilizza un percorso con la stringa "*" per trovare una corrispondenza in tutti i campi.

UpdateConversionEventRequest

Messaggio di richiesta per l'RPC UpdateConversionEvent

Campi
conversion_event

ConversionEvent

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

update_mask

FieldMask

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

UpdateCustomDimensionRequest

Messaggio di richiesta per l'RPC UpdateCustomDimension.

Campi
custom_dimension

CustomDimension

La dimensione personalizzata da aggiornare

update_mask

FieldMask

Obbligatorio. 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 una corrispondenza in tutti i campi.

UpdateCustomMetricRequest

Messaggio di richiesta per l'RPC UpdateCustomMetric.

Campi
custom_metric

CustomMetric

La metrica personalizzata da aggiornare

update_mask

FieldMask

Obbligatorio. 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 una corrispondenza in tutti i campi.

UpdateDataRetentionSettingsRequest

Messaggio di richiesta per l'RPC UpdateDataRetentionSettings.

Campi
data_retention_settings

DataRetentionSettings

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

update_mask

FieldMask

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

UpdateDataStreamRequest

Messaggio di richiesta per l'RPC UpdateDataStream.

Campi
data_stream

DataStream

Il DataStream da aggiornare

update_mask

FieldMask

Obbligatorio. 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 una corrispondenza in tutti i campi.

UpdateGoogleAdsLinkRequest

Messaggio di richiesta per l'RPC UpdateGoogleAdsLink

Campi
update_mask

FieldMask

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

UpdateKeyEventRequest

Messaggio di richiesta per l'RPC UpdateKeyEvent

Campi
key_event

KeyEvent

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

update_mask

FieldMask

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

UpdateMeasurementProtocolSecretRequest

Messaggio di richiesta per l'RPC UpdateMeasurementProtocolSecret

Campi
measurement_protocol_secret

MeasurementProtocolSecret

Obbligatorio. L'API secret Measurement Protocol da aggiornare.

update_mask

FieldMask

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

UpdatePropertyRequest

Messaggio di richiesta per l'RPC UpdateProperty.

Campi
property

Property

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

update_mask

FieldMask

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