REST Resource: properties

Ressource: Property

Eine Ressourcennachricht, die eine Google Analytics GA4-Property darstellt.

JSON-Darstellung
{
  "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
}
Felder
name

string

Nur Ausgabe. Ressourcenname dieser Property. Format: properties/{property_id} Beispiel: „properties/1000“

propertyType

enum (PropertyType)

Nicht veränderbar. Der Property-Typ für diese Property-Ressource. Wenn Sie eine Property erstellen und der Typ „PROPERTY_TYPE_UNSPECIFIED“ ist, wird „ORDINARY_PROPERTY“ impliziert. Die Typen "SUBPROPERTY" und "ROLLUP_PROPERTY" können noch nicht mit der Google Analytics Admin API erstellt werden.

createTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem die Entität ursprünglich erstellt wurde.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit einer Auflösung von Nanosekunden und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Nur Ausgabe. Zeit, zu der die Nutzlastfelder der Entität zuletzt aktualisiert wurden.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit einer Auflösung von Nanosekunden und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

parent

string

Nicht veränderbar. Ressourcenname des logischen übergeordneten Elements dieser Property.

Hinweis: Über die UI zum Verschieben von Properties kann das übergeordnete Element geändert werden. Format: accounts/{account}, properties/{property}. Beispiel: "accounts/100", "properties/101"

displayName

string

Erforderlich. Für Menschen lesbarer Anzeigename für diese Property.

Die maximal zulässige Länge des Anzeigenamens beträgt 100 UTF-16-Codeeinheiten.

industryCategory

enum (IndustryCategory)

Mit dieser Property verknüpfte Branche Beispiel: AUTOMOTIVE, FOOD_AND_DRINK

timeZone

string

Erforderlich. Zeitzone für Berichte, die als Tagesgrenze für Berichte verwendet wird, unabhängig davon, woher die Daten stammen. Wird die Sommerzeit berücksichtigt, werden die Änderungen in Analytics automatisch berücksichtigt.

HINWEIS: Wenn Sie die Zeitzone ändern, wirkt sich das nur auf zukünftige Daten aus.

Format: https://www.iana.org/time-zones Beispiel: „America/Los_Angeles“

currencyCode

string

Der Währungstyp, der in Berichten mit Geldwerten verwendet wird.

Format: https://de.wikipedia.org/wiki/ISO_4217 Beispiele: "USD", "EUR", "JPY"

serviceLevel

enum (ServiceLevel)

Nur Ausgabe. Die Google Analytics-Serviceebene, die für diese Property gilt.

deleteTime

string (Timestamp format)

Nur Ausgabe. Falls festgelegt, der Zeitpunkt, zu dem diese Property in den Papierkorb verschoben wurde. Wenn sie nicht konfiguriert ist, befindet sich diese Property derzeit nicht im Papierkorb.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit einer Auflösung von Nanosekunden und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

expireTime

string (Timestamp format)

Nur Ausgabe. Wenn festgelegt, wird der Zeitpunkt, zu dem diese in den Papierkorb verschobene Property endgültig gelöscht wird. Wenn sie nicht konfiguriert ist, befindet sich diese Property derzeit nicht im Papierkorb und darf nicht gelöscht werden.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit einer Auflösung von Nanosekunden und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

account

string

Nicht veränderbar. Der Ressourcenname des übergeordneten Kontos Format: accounts/{account_id} Beispiel: "accounts/123"

Property-Typ

Arten von Property-Ressourcen.

Enums
PROPERTY_TYPE_UNSPECIFIED Unbekannter oder nicht angegebener Property-Typ
PROPERTY_TYPE_ORDINARY Gewöhnliche GA4-Property
PROPERTY_TYPE_SUBPROPERTY Untergeordnete GA4-Property
PROPERTY_TYPE_ROLLUP GA4-Rollup-Property

Branche

Die für diese Property ausgewählte Kategorie, die für Branchen-Benchmarking verwendet wird.

Enums
INDUSTRY_CATEGORY_UNSPECIFIED Branche nicht angegeben
AUTOMOTIVE Automobil
BUSINESS_AND_INDUSTRIAL_MARKETS Wirtschaft und Industrie
FINANCE Finanzen
HEALTHCARE Gesundheitswesen
TECHNOLOGY Technologie
TRAVEL Reise
OTHER Andere
ARTS_AND_ENTERTAINMENT Kunst und Unterhaltung
BEAUTY_AND_FITNESS Schönheit und Fitness
BOOKS_AND_LITERATURE Bücher und Literatur
FOOD_AND_DRINK Essen und Trinken
GAMES Spiele
HOBBIES_AND_LEISURE Hobbys und Freizeit
HOME_AND_GARDEN Haus und Garten
INTERNET_AND_TELECOM Internet und Telekommunikation
LAW_AND_GOVERNMENT Justiz und Behörden
NEWS News
ONLINE_COMMUNITIES Online-Communities
PEOPLE_AND_SOCIETY Mensch und Gesellschaft
PETS_AND_ANIMALS Haustiere und Tiere
REAL_ESTATE Immobilien
REFERENCE Referenz
SCIENCE Wissenschaft
SPORTS Sporteinrichtungen
JOBS_AND_EDUCATION Arbeit und Bildung
SHOPPING Shopping

Servicelevel

Verschiedene Servicelevels für Google Analytics

Enums
SERVICE_LEVEL_UNSPECIFIED Dienstebene nicht angegeben oder ungültig.
GOOGLE_ANALYTICS_STANDARD Die Standardversion von Google Analytics.
GOOGLE_ANALYTICS_360 Die kostenpflichtige Premium-Version von Google Analytics.

Methoden

acknowledgeUserDataCollection

Die Bedingungen für die Erhebung von Nutzerdaten für die angegebene Property werden bestätigt.

create

Erstellt eine GA4-Property mit dem angegebenen Standort und den angegebenen Attributen.

delete

Markiert die Ziel-Property als vorläufig gelöscht (d. h., „in Papierkorb verschoben“) und gibt sie zurück.

get

Suchen Sie nach einer einzelnen GA4-Property.

getDataRetentionSettings

Gibt die Einstellungen für die Aufbewahrung von Singleton-Daten für diese Property zurück.

list

Gibt untergeordnete Properties unter dem angegebenen übergeordneten Konto zurück.

patch

Aktualisiert eine Property.

runAccessReport

Gibt einen benutzerdefinierten Bericht zu Datenzugriffseinträgen zurück.

updateDataRetentionSettings

Aktualisiert die Einstellungen für die Aufbewahrung von Singleton-Daten für diese Property.