REST Resource: properties.subpropertyEventFilters

Ressource: SubpropertyEventFilter

Eine Ressourcennachricht, die einen Ereignisfilter in einer untergeordneten 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 bestimmen, 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, die die Filterklausel erfüllen, sind in den Daten der untergeordneten Property enthalten) 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 dafür, welche Ereignisse an die untergeordnete Property gesendet werden.

FilterClauseType

Gibt an, ob dies eine Klausel des Einschluss- oder Ausschlusses ist.

Enums
FILTER_CLAUSE_TYPE_UNSPECIFIED Der Typ der Filterklausel ist 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. Der 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 OR verknüpft werden sollen. Darf nur Ausdrücke vom Typ „notExpression“ oder „filterCondition“ enthalten.
notExpression

object (SubpropertyEventFilterExpression)

Ein Filterausdruck, der NICHT verwendet werden soll (umgekehrt, komplementiert). Er 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 von Ereignisfilterausdrücken für untergeordnete Properties.

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

object (SubpropertyEventFilterExpression)

Erforderlich. Unsortierte Liste. Liste mit Ereignisfilterausdrücken 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. Falls wahr, wird beim Stringwert zwischen Groß- und Kleinschreibung unterschieden. Bei „false“ wird die Groß-/Kleinschreibung nicht berücksichtigt.

MatchType

Wie der Filter zur Ermittlung einer Übereinstimmung verwendet wird.

Enums
MATCH_TYPE_UNSPECIFIED Keyword-Option unbekannt oder nicht angegeben.
EXACT Genaue Übereinstimmung mit dem Stringwert.
BEGINS_WITH Beginnt mit dem Stringwert.
ENDS_WITH Endet mit dem Stringwert.
CONTAINS Enthält den Stringwert.
FULL_REGEXP Der vollständige reguläre Ausdruck stimmt mit dem Stringwert überein.
PARTIAL_REGEXP Der Teil des regulären Ausdrucks stimmt mit dem Stringwert überein.

Methoden

create

 Erstellt einen Ereignisfilter für eine untergeordnete Property.

delete

 Löscht einen Ereignisfilter für untergeordnete Properties.

get

 Suche nach einem einzelnen Ereignisfilter der untergeordneten Property.

list

 Hiermit werden alle Ereignisfilter einer untergeordneten Property aufgelistet.

patch

 Aktualisiert einen Ereignisfilter einer untergeordneten Property.