Standardmäßig enthält ein Bericht alle Daten im reportScope, die in Ihrer Anfrage angegeben sind. Wenn ein Bericht nur Daten enthalten soll, Kriterien, können Sie einem Bericht einen oder mehrere Filter hinzufügen. Nur Zeilen, die alle Filter erfüllen zurückgegeben.
Sie können beispielsweise einen Bericht über alle Keywords in einer Agentur anfordern. Dann können Sie einen Filter festlegen, sodass nur Keywords, deren Landingpage-URLs mit www.beispiel.de und www.andere-beispielurl.de werden im Bericht angezeigt.
"filters": [ { "column" : { "columnName": "keywordLandingPage" }, "operator" : "startsWith", "values" : [ "http://www.example.com", "http://www.another-example.com" ] } ]
Jeder Filter gibt eine zu filternde Spalte, einen Operator und eine Liste von Werten an, in der angegebenen Spalte enthalten sein müssen:
"filters": [ { "column" : column to filter on, "operator" : operator specifying the type of filter, "values" : list of values }, { ... another filter can go here ... } ]
Filterable
.
Operatoren filtern
Bei allen Filtern wird zwischen Groß- und Kleinschreibung unterschieden. Das heißt, ein Filter mit „www.Sprockets.com“ stimmt nicht überein mit eine Spalte, die „www.sprockets.com“ enthält.
Operator | Beschreibung | Anzahl der unterstützten Werte |
---|---|---|
equals |
Die Spalte muss genau mit dem angegebenen Wert übereinstimmen. | 1 |
notEquals |
Die Spalte darf nicht mit dem angegebenen Wert übereinstimmen. | 1 |
in |
Die Spalte muss genau mit einem der Werte in der Filterliste übereinstimmen.
Nicht gültig für Listendatentypen (z. B. |
variabel |
lessThan |
Die Spalte muss einen Wert enthalten, der kleiner als der angegebene Wert ist.
Wenn Sie diesen Filter für eine Nicht gültig für Listendatentypen (z. B. |
1 |
greaterThan |
Die Spalte muss einen Wert enthalten, der größer als einer der Werte in in der Filterliste.
Wenn Sie diesen Filter für eine
Nicht gültig für Listendatentypen (z. B. |
1 |
lessThanOrEqual |
Die Spalte muss einen Wert enthalten, der kleiner oder gleich einem der Werte in der Filterliste anzeigen.
Wenn Sie diesen Filter für eine
Nicht gültig für Listendatentypen (z. B. |
1 |
greaterThanOrEqual |
Die Spalte muss einen Wert enthalten, der größer oder gleich einem der Werte in der Filterliste anzeigen.
Wenn Sie diesen Filter für eine
Nicht gültig für Listendatentypen (z. B. |
1 |
isNull |
Die Spalte muss leer sein. Wenn Sie beispielsweise isNull angeben,
für die Spalte keywordMaxCpc in einem Keyword-Bericht wird der Bericht
enthält nur Keywords, für die kein max. CPC angegeben ist.
|
0 |
isNotNull |
Die Spalte muss einen Wert enthalten. | 0 |
startsWith |
Die Spalte muss mit einem der Strings in der Liste des Filters beginnen.
Nur gültig für |
variabel |
containsSubstring |
Die Spalte muss eine der Zeichenfolgen, die in der Filterliste.
Beispielsweise ein
würde jedoch keine Zeilen mit diesen Werten zurückgeben:
Nur gültig für |
variabel |
doesNotContainSubstring |
Die Spalte darf keinen String in der Liste des Filters enthalten.
Beispielsweise ein würde jedoch keine Zeilen mit diesen Werten zurückgeben:
Nur gültig für |
variabel |
containsElement |
Die Spalte muss mindestens einen der Werte in der Filterliste enthalten.
Nur gültig für Spalten mit Listendatentypen (z. B.
Beispiel: In einem |
variabel |