Standardmäßig enthält der Bericht alle Daten innerhalb des reportScope, den Sie in Ihrer Anfrage angeben. Wenn ein Bericht nur die Daten enthalten soll, die bestimmten Kriterien entsprechen, können Sie ihm einen oder mehrere Filter hinzufügen. Es werden nur Zeilen zurückgegeben, die alle Filter erfüllen.
Sie können beispielsweise einen Bericht zu allen Keywords in einer Agentur anfordern. Anschließend können Sie einen Filter angeben, sodass nur Keywords im Bericht erscheinen, deren Landingpage-URLs mit www.beispiel.de und www.andere-beispiel.de beginnen.
"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 der Werte an, die in der angegebenen Spalte enthalten sein sollen:
"filters": [ { "column" : column to filter on, "operator" : operator specifying the type of filter, "values" : list of values }, { ... another filter can go here ... } ]
Filterable
ist.
Filteroperatoren
Bei allen Filtern wird zwischen Groß- und Kleinschreibung unterschieden. Ein Filter mit „www.Sprockets.com“ stimmt also nicht mit einer Spalte überein, die „www.sprockets.com“ enthält.
Betreiber | 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 Liste des Filters übereinstimmen.
Nicht gültig für Listendatentypen (z. B. |
Variable |
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 der Liste des Filters ist.
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 ist.
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 Liste des Filters ist.
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 für die Spalte keywordMaxCpc in einem Keyword-Bericht angeben, enthält der Bericht 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 |
Variable |
containsSubstring |
Die Spalte muss einen der in der Filterliste angegebenen Strings vollständig oder teilweise enthalten.
Ein
würde jedoch keine Zeilen mit diesen Werten zurückgeben:
Nur gültig für |
Variable |
doesNotContainSubstring |
Die Spalte darf keinen String enthalten, der in der Liste des Filters enthalten ist.
Ein würde jedoch keine Zeilen mit diesen Werten zurückgeben:
Nur gültig für |
Variable |
containsElement |
Die Spalte muss mindestens einen der Werte in der Liste des Filters enthalten.
Nur gültig für Spalten mit Listendatentypen (z. B.
In einem |
Variable |