Varsayılan olarak raporunuz, isteğinizin reportScope bölümünde belirtilen tüm verileri içerir. Bir raporun yalnızca bir ölçüt grubuyla eşleşen verileri içermesini isterseniz rapora bir veya daha fazla filtre ekleyebilirsiniz. Yalnızca tüm filtreleri karşılayan satırlar döndürülür.
Örneğin, bir ajanstaki tüm anahtar kelimelerin raporunu isteyebilirsiniz. Ardından, yalnızca açılış sayfası URL'leri www.example.com ve www.another-example.com ile başlayan anahtar kelimelerin raporda görünmesi için bir filtre belirtebilirsiniz.
"filters": [ { "column" : { "columnName": "keywordLandingPage" }, "operator" : "startsWith", "values" : [ "http://www.example.com", "http://www.another-example.com" ] } ]
Her filtre, filtrelenecek bir sütun, bir operatör ve belirtilen sütunda olması beklenen bir değerler listesi belirtir:
"filters": [ { "column" : column to filter on, "operator" : operator specifying the type of filter, "values" : list of values }, { ... another filter can go here ... } ]
Filterable
olup olmadığı belirtilir.
Filtre operatörleri
Tüm filtreler büyük/küçük harfe duyarlıdır. Yani "www.Sprockets.com" içeren bir filtre, "www.sprockets.com" değerini içeren bir sütunla eşleşmez.
Operatör | Açıklama | Desteklenen değer sayısı |
---|---|---|
equals |
Sütun, belirtilen değerle tam olarak eşleşmelidir. | 1 |
notEquals |
Sütun belirtilen değerle eşleşmemelidir. | 1 |
in |
Sütun, filtrenin listesindeki değerlerden biriyle tam olarak eşleşmelidir.
Liste veri türleri ( |
değişken |
lessThan |
Sütun, belirtilen değerden küçük bir değer içermelidir.
Bir Liste veri türleri ( |
1 |
greaterThan |
Sütun, filtrenin listesindeki değerlerin birinden büyük bir değer içermelidir.
Bir
Liste veri türleri ( |
1 |
lessThanOrEqual |
Sütun, filtrenin listesindeki değerlerden birine eşit veya daha küçük bir değer içermelidir.
Bir
Liste veri türleri ( |
1 |
greaterThanOrEqual |
Sütun, filtrenin listesindeki değerlerden birine eşit veya daha büyük bir değer içermelidir.
Bir
Liste veri türleri ( |
1 |
isNull |
Sütun boş olmalıdır. Örneğin, bir anahtar kelime raporundaki keywordMaxCpc sütunu için isNull değerini belirtirseniz rapor yalnızca Maks. TBM belirtmeyen anahtar kelimeleri içerir.
|
0 |
isNotNull |
Sütun bir değer içermelidir. | 0 |
startsWith |
Sütun, filtre listesindeki dizelerden biriyle başlamalıdır.
Yalnızca |
değişken |
containsSubstring |
Sütun, filtre listesinde belirtilen dizelerden birinin tamamını veya bir kısmını içermelidir.
Örneğin,
ancak şu değerlere sahip satırları döndürmez:
Yalnızca |
değişken |
doesNotContainSubstring |
Sütun, filtre listesindeki dizelerin hiçbirini içermemelidir.
Örneğin, ancak şu değerlere sahip satırlar döndürülmez:
Yalnızca |
değişken |
containsElement |
Sütun, filtre listesindeki değerlerden en az birini içermelidir.
Yalnızca liste veri türlerini (
Örneğin bir |
değişken |