REST Resource: properties

Ressource: Property

Eine Ressourcennachricht für eine GA4-Property in Google Analytics.

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 dieses Attributs. Format: properties/{property_id}, Beispiel: „properties/1000“

propertyType

enum (PropertyType)

Nicht veränderbar. Der Attributtyp für diese Property-Ressource. Wenn beim Erstellen einer Property der Typ „PROPERTY_TYPE_UNSPECIFIED“ ist, ist „ORDINARY_PROPERTY“ impliziert.

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 im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem Entitätsnutzlastfelder zuletzt aktualisiert wurden.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich 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 Eigenschaft.

Hinweis: Über die Benutzeroberfläche zum Verschieben von Properties kann das übergeordnete Element geändert werden. Format: Konten/{Konto}, Properties/{Property} Beispiel: "Konten/100", "Properties/101"

displayName

string

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

Die maximal zulässige Länge eines 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: Diese Zeitzone wird als Datumsgrenze für Berichte verwendet, unabhängig davon, woher die Daten stammen. Sofern in der Zeitzone die Sommerzeit berücksichtigt wird, werden die Änderungen in Analytics automatisch angepasst.

HINWEIS: Änderungen an der Zeitzone werden nicht rückwirkend angewendet, sondern wirken sich 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 zu Geldwerten verwendet wird.

Format: https://en.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. Der Zeitpunkt, zu dem diese Property in den Papierkorb verschoben wurde, sofern festgelegt. Wenn die Richtlinie nicht konfiguriert ist, befindet sich diese Property derzeit nicht im Papierkorb.

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

expireTime

string (Timestamp format)

Nur Ausgabe. Falls festgelegt, wird der Zeitpunkt, zu dem diese im Papierkorb verschobene Property endgültig gelöscht wird, endgültig gelöscht. Wenn die Richtlinie nicht konfiguriert ist, befindet sich diese Property nicht im Papierkorb und wird auch nicht gelöscht.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich 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"

PropertyType

Arten von Property-Ressourcen.

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

IndustryCategory

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

Enums
INDUSTRY_CATEGORY_UNSPECIFIED Branchenkategorie nicht angegeben
AUTOMOTIVE Automobil
BUSINESS_AND_INDUSTRIAL_MARKETS Wirtschaft und Industrie
FINANCE Finanzen
HEALTHCARE Gesundheitswesen
TECHNOLOGY Technologie
TRAVEL Reisen
OTHER Sonstiges
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 Nachrichten
ONLINE_COMMUNITIES Online-Communities
PEOPLE_AND_SOCIETY Mensch und Gesellschaft
PETS_AND_ANIMALS Haustiere und Tiere
REAL_ESTATE Immobilien
REFERENCE Referenz
SCIENCE Wissenschaft
SPORTS Sport
JOBS_AND_EDUCATION Arbeit und Bildung
SHOPPING Shopping

ServiceLevel

Verschiedene Servicelevels für Google Analytics

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

Methoden

acknowledgeUserDataCollection

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

create

Eine GA4-Property wird erstellt mit dem angegebenen Standort und den angegebenen Attributen.

delete

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

get

Einzelne „GA4“ suchen Property.

getDataRetentionSettings

Gibt die Einstellungen für die Singleton-Datenaufbewahrung 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 über Datenzugriffsdatensätze zurück.

updateDataRetentionSettings

Aktualisiert die Einstellungen für die Singleton-Datenaufbewahrung für diese Property.