REST Resource: properties.subpropertyEventFilters

Ressource: SubpropertyEventFilter

Eine Ressourcennachricht, die einen Ereignisfilter für eine untergeordnete GA4-Property darstellt.

JSON-Darstellung
{
  "name": string,
  "filterClauses": [
    {
      object (SubpropertyEventFilterClause)
    }
  ],
  "applyToProperty": string
}
Felder
name

string

Nur Ausgabe. Format: Properties/{ordinary_property_id}/subpropertyEventFilters/{sub_property_event_filter} Beispiel: properties/1234/subpropertyEventFilters/5678

filterClauses[]

object (SubpropertyEventFilterClause)

Erforderlich. Unsortierte Liste. Filterklauseln, die den SubpropertyEventFilter definieren. Alle Klauseln werden durch UND verbunden, um zu ermitteln, welche Daten an die untergeordnete Property gesendet werden.

applyToProperty

string

Nicht veränderbar. Ressourcenname der untergeordneten Property, die diesen Filter verwendet.

SubpropertyEventFilterClause

Eine Klausel zum Definieren eines Filters. Ein Filter kann einschließend sein (Ereignisse, für die die Filterklausel erfüllt ist, werden in die Daten der untergeordneten Property aufgenommen) oder exklusiv (Ereignisse, die die Filterklausel erfüllen, werden aus den Daten der untergeordneten Property ausgeschlossen).

JSON-Darstellung
{
  "filterClauseType": enum (FilterClauseType),
  "filterExpression": {
    object (SubpropertyEventFilterExpression)
  }
}
Felder
filterClauseType

enum (FilterClauseType)

Erforderlich. Der Typ der Filterklausel.

filterExpression

object (SubpropertyEventFilterExpression)

Erforderlich. Der logische Ausdruck für die Ereignisse, die an die untergeordnete Property gesendet werden.

FilterClauseType

Gibt an, ob es sich um eine Einschließen- oder Ausschließen-Filterklausel handelt.

Enums
FILTER_CLAUSE_TYPE_UNSPECIFIED Typ der Filterklausel unbekannt oder nicht angegeben.
INCLUDE Ereignisse werden in die untergeordnete Property aufgenommen, wenn die Filterklausel erfüllt ist.
EXCLUDE Ereignisse werden aus der untergeordneten Property ausgeschlossen, wenn die Filterklausel erfüllt ist.

SubpropertyEventFilterExpression

Ein logischer Ausdruck von Ereignisfiltern für untergeordnete Properties.

JSON-Darstellung
{

  // Union field expr can be only one of the following:
  "orGroup": {
    object (SubpropertyEventFilterExpressionList)
  },
  "notExpression": {
    object (SubpropertyEventFilterExpression)
  },
  "filterCondition": {
    object (SubpropertyEventFilterCondition)
  }
  // End of list of possible types for union field expr.
}
Felder
Union-Feld expr. Ausdruck, der auf einen Filter angewendet wird. Für expr ist nur einer der folgenden Werte zulässig:
orGroup

object (SubpropertyEventFilterExpressionList)

Eine Liste von Ausdrücken, die mit ODER verbunden werden sollen. Darf nur notExpression- oder filterCondition-Ausdrücke enthalten.

notExpression

object (SubpropertyEventFilterExpression)

Ein Filterausdruck, der NICHT behandelt werden soll (umgekehrt, komplementiert). Sie darf nur einen Filter enthalten. Dies kann nicht auf der obersten Ebene "SubpropertyEventFilterExpression" festgelegt werden.

filterCondition

object (SubpropertyEventFilterCondition)

Erstellt einen Filter, der einem bestimmten Ereignis entspricht. Dies kann nicht auf der obersten Ebene "SubpropertyEventFilterExpression" festgelegt werden.

SubpropertyEventFilterExpressionList

Eine Liste mit Ausdrücken für Ereignisfilter für untergeordnete Properties.

JSON-Darstellung
{
  "filterExpressions": [
    {
      object (SubpropertyEventFilterExpression)
    }
  ]
}
Felder
filterExpressions[]

object (SubpropertyEventFilterExpression)

Erforderlich. Unsortierte Liste. Liste mit Ausdrücken für Ereignisfilter für untergeordnete Properties

SubpropertyEventFilterCondition

Einen bestimmten Filterausdruck

JSON-Darstellung
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "nullFilter": boolean,
  "stringFilter": {
    object (StringFilter)
  }
  // End of list of possible types for union field one_filter.
}
Felder
fieldName

string

Erforderlich. Das Feld, das gefiltert wird.

Union-Feld one_filter.

Für one_filter ist nur einer der folgenden Werte zulässig:

nullFilter

boolean

Ein Filter für Nullwerte.

stringFilter

object (StringFilter)

Ein Filter für eine Dimension vom Typ „String“, die mit einem bestimmten Muster übereinstimmt.

StringFilter

Ein Filter für eine Dimension vom Typ „String“, die mit einem bestimmten Muster übereinstimmt.

JSON-Darstellung
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
Felder
matchType

enum (MatchType)

Erforderlich. Der Übereinstimmungstyp für den Stringfilter.

value

string

Erforderlich. Der für den Abgleich verwendete Stringwert.

caseSensitive

boolean

Optional. Bei „true“ wird die Groß- und Kleinschreibung beim Stringwert beachtet. Bei „false“ wird die Groß-/Kleinschreibung nicht berücksichtigt.

MatchType

Mit diesem Filter wird eine Übereinstimmung ermittelt.

Enums
MATCH_TYPE_UNSPECIFIED Keyword-Option unbekannt oder nicht angegeben.
EXACT Genaue Übereinstimmung mit dem Stringwert.
BEGINS_WITH Beginnt mit dem Stringwert.
ENDS_WITH Er endet mit dem Stringwert.
CONTAINS Enthält den Stringwert.
FULL_REGEXP Der vollständige reguläre Ausdruck stimmt mit dem Stringwert überein.
PARTIAL_REGEXP Ein teilweiser regulärer Ausdruck stimmt mit dem Stringwert überein.

Methoden

create

Erstellt einen Ereignisfilter für eine untergeordnete Property.

delete

Löscht den Ereignisfilter einer untergeordneten Property.

get

Suchen Sie nach einem einzelnen Ereignisfilter für eine untergeordnete Property.

list

Hiermit werden alle Ereignisfilter für eine untergeordnete Property aufgelistet.

patch

Aktualisiert einen Ereignisfilter für eine untergeordnete Property.