REST Resource: properties

Risorsa: proprietà

Un messaggio della 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 della risorsa di questa proprietà. Formato: proprietà/{property_id} Esempio: "properties/1000"

propertyType

enum (PropertyType)

Immutabile. Il tipo di proprietà per questa risorsa Proprietà. Quando crei una proprietà, se il tipo è "PROPERTY_TYPE_UNSPECIFIED", allora "ORDINARY_PROPERTY" sono implicite.

createTime

string (Timestamp format)

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

Un timestamp nel formato RFC3339 UTC "Zulu" 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 e ora dell'ultimo aggiornamento dei campi del payload delle entità.

Un timestamp nel formato RFC3339 UTC "Zulu" 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 della risorsa del padre logico di questa proprietà.

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

displayName

string

Obbligatorio. Nome visualizzato leggibile per questa proprietà.

La lunghezza massima consentita per il nome visualizzato è di 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, a prescindere dalla località di origine dei dati. Se il fuso orario rispetta l'ora legale, Analytics si adeguerà automaticamente alle 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 impostato, indica l'ora in cui la proprietà è stata spostata nel cestino. Se non viene configurato, questa proprietà non è attualmente nel cestino.

Un timestamp nel formato RFC3339 UTC "Zulu" 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 impostato, l'ora in cui la proprietà spostata nel cestino verrà eliminata definitivamente. Se non viene configurato, questa proprietà non è attualmente nel cestino e non è prevista per l'eliminazione.

Un timestamp nel formato RFC3339 UTC "Zulu" 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 della 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 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 Scienza
SPORTS Sport
JOBS_AND_EDUCATION Lavoro e istruzione
SHOPPING Shopping

ServiceLevel

Diversi 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

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

create

Crea un "GA4" con la posizione e gli attributi specificati.

delete

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

get

Cerca un singolo "GA4" Proprietà.

getDataRetentionSettings

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

list

Restituisce le proprietà secondarie dell'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à.