Per impostazione predefinita, il report conterrà tutti i dati all'interno dell'elemento reportScope specificato nella richiesta. Se vuoi che un report contenga solo i dati che corrispondono a un insieme di criteri, puoi aggiungere uno o più filtri al report. Vengono restituite solo le righe che soddisfano tutti i filtri.
Ad esempio, puoi richiedere un report su tutte le parole chiave di un'agenzia. Dopodiché puoi specificare un filtro in modo che nel report vengano visualizzate solo le parole chiave con URL pagina di destinazione che iniziano con www.example.com e www.another-example.com.
"filters": [ { "column" : { "columnName": "keywordLandingPage" }, "operator" : "startsWith", "values" : [ "http://www.example.com", "http://www.another-example.com" ] } ]
Ogni filtro specifica una colonna da filtrare, un operatore e un elenco di valori che dovrebbero essere presenti nella colonna specificata:
"filters": [ { "column" : column to filter on, "operator" : operator specifying the type of filter, "values" : list of values }, { ... another filter can go here ... } ]
Filterable
.
Operatori di filtro
Tutti i filtri fanno distinzione tra maiuscole e minuscole. In altre parole, un filtro con "www.Spskus.com" non troverà una corrispondenza con una colonna che contiene "www.sprays.com".
Operatore | Descrizione | Numero di valori supportati |
---|---|---|
equals |
La colonna deve corrispondere esattamente al valore specificato. | 1 |
notEquals |
La colonna non deve corrispondere al valore specificato. | 1 |
in |
La colonna deve corrispondere esattamente a uno dei valori nell'elenco del filtro.
Non valido per i tipi di dati dell'elenco (come |
variabile |
lessThan |
La colonna deve contenere un valore inferiore a quello specificato.
Se specifichi questo filtro per una colonna Non valido per i tipi di dati dell'elenco (come |
1 |
greaterThan |
La colonna deve contenere un valore maggiore di uno dei valori nell'elenco del filtro.
Se specifichi questo filtro per una colonna
Non valido per i tipi di dati dell'elenco (come |
1 |
lessThanOrEqual |
La colonna deve contenere un valore inferiore o uguale a uno dei valori nell'elenco del filtro.
Se specifichi questo filtro per una colonna
Non valido per i tipi di dati dell'elenco (come |
1 |
greaterThanOrEqual |
La colonna deve contenere un valore maggiore o uguale a uno dei valori nell'elenco del filtro.
Se specifichi questo filtro per una colonna
Non valido per i tipi di dati dell'elenco (come |
1 |
isNull |
La colonna deve essere vuota. Ad esempio, se specifichi isNull
per la colonna keywordMaxCpc in un report sulle parole chiave, il report
conterrà solo le parole chiave per le quali non è stato specificato un CPC max.
|
0 |
isNotNull |
La colonna deve contenere un valore. | 0 |
startsWith |
La colonna deve iniziare con una delle stringhe presenti nell'elenco del filtro.
Valido solo per |
variabile |
containsSubstring |
La colonna deve contenere tutta o parte di una delle stringhe specificate nell'elenco del filtro.
Ad esempio, un filtro
ma non restituisce righe con questi valori:
Valido solo per |
variabile |
doesNotContainSubstring |
La colonna non deve contenere nessuna delle stringhe presenti nell'elenco del filtro.
Ad esempio, un filtro ma non restituirebbe righe con questi valori:
Valido solo per |
variabile |
containsElement |
La colonna deve contenere almeno uno dei valori presenti nell'elenco del filtro.
Valido solo per le colonne con tipi di dati dell'elenco (come
Ad esempio, in un report |
variabile |