REST Resource: properties

Risorsa: proprietà

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

Rappresentazione JSON
{
  "name": string,
  "propertyType": enum (PropertyType),
  "createTime": string,
  "updateTime": string,
  "parent": string,
  "displayName": string,
  "industryCategory": enum (IndustryCategory),
  "timeZone": string,
  "currencyCode": string,
  "serviceLevel": enum (ServiceLevel),
  "deleteTime": string,
  "expireTime": string,
  "account": string
}
Campi
name

string

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

propertyType

enum (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".

createTime

string (Timestamp format)

Solo output. Data e ora di creazione originale dell'entità.

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

updateTime

string (Timestamp format)

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

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

parent

string

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

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

displayName

string

Obbligatorio. Nome visualizzato leggibile per questa proprietà.

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

industryCategory

enum (IndustryCategory)

Settore associato a questa proprietà Esempio: AUTOMOTIVE, FOOD_AND_DRINK

timeZone

string

Obbligatorio. Fuso orario dei report, utilizzato come giorno limite per i report, indipendentemente dalla località di origine dei dati. Se il fuso orario rispetta l'ora legale, Analytics adeguerà 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"

currencyCode

string

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

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

serviceLevel

enum (ServiceLevel)

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

deleteTime

string (Timestamp format)

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.

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

expireTime

string (Timestamp format)

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

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

account

string

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

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

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 Immobili
REFERENCE Riferimento
SCIENCE Scienza
SPORTS Sport
JOBS_AND_EDUCATION Lavoro e istruzione
SHOPPING Shopping

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.

Metodi

acknowledgeUserDataCollection

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

create

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

delete

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

get

Cerca una singola proprietà "GA4".

getDataRetentionSettings

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

list

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

patch

Aggiorna una proprietà.

runAccessReport

Restituisce un report personalizzato dei record di accesso ai dati.

updateDataRetentionSettings

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