Por padrão, seu relatório contém todos os dados no reportScope que sua solicitação especifica. Se você quiser que um relatório tenha somente os dados que correspondem a um conjunto de critérios, adicione um ou mais filtros a ele. Somente as linhas que satisfazem todos os filtros são retornadas.
Por exemplo, você pode solicitar um relatório de todas as palavras-chave em uma agência. Em seguida, é possível especificar um filtro para que somente as palavras-chave com URLs da página de destino começando com www.example.com e www.another-example.com apareçam no relatório.
"filters": [ { "column" : { "columnName": "keywordLandingPage" }, "operator" : "startsWith", "values" : [ "http://www.example.com", "http://www.another-example.com" ] } ]
Cada filtro especifica uma coluna a ser filtrada, um operador e uma lista de valores que devem estar na coluna especificada:
"filters": [ { "column" : column to filter on, "operator" : operator specifying the type of filter, "values" : list of values }, { ... another filter can go here ... } ]
Filterable
.
Operadores de filtro
Todos os filtros diferenciam maiúsculas de minúsculas. Ou seja, um filtro com "www.Sprockets.com" não vai corresponder a uma coluna que contenha "www.sprockets.com".
Operador | Descrição | Número de valores compatíveis |
---|---|---|
equals |
A coluna precisa corresponder exatamente ao valor especificado. | 1 |
notEquals |
A coluna não pode corresponder ao valor especificado. | 1 |
in |
A coluna precisa corresponder exatamente a um dos valores na lista do filtro.
Não é válido para tipos de dados de lista (como |
variável |
lessThan |
A coluna precisa conter um valor menor que o especificado.
Se você especificar esse filtro para uma coluna Não é válido para tipos de dados de lista (como |
1 |
greaterThan |
A coluna precisa conter um valor maior que um dos valores na lista do filtro.
Se você especificar esse filtro para uma coluna
Não é válido para tipos de dados de lista (como |
1 |
lessThanOrEqual |
A coluna precisa conter um valor menor ou igual a um dos valores na lista do filtro.
Se você especificar esse filtro para uma coluna
Não é válido para tipos de dados de lista (como |
1 |
greaterThanOrEqual |
A coluna precisa conter um valor maior ou igual a um dos valores na lista do filtro.
Se você especificar esse filtro para uma coluna
Não é válido para tipos de dados de lista (como |
1 |
isNull |
A coluna precisa estar vazia. Por exemplo, se você especificar isNull para a coluna keywordMaxCpc em um relatório de palavras-chave, ele conterá somente palavras-chave que não especificaram um CPC máx.
|
0 |
isNotNull |
A coluna precisa conter um valor. | 0 |
startsWith |
A coluna precisa começar com uma das strings da lista do filtro.
Válida apenas para |
variável |
containsSubstring |
A coluna precisa conter todas ou parte de uma das strings especificadas na lista do filtro.
Por exemplo, um filtro
mas não retornaria linhas com estes valores:
Válida apenas para |
variável |
doesNotContainSubstring |
A coluna não pode conter nenhuma das strings da lista do filtro.
Por exemplo, um filtro mas não retornaria linhas com estes valores:
Válida apenas para |
variável |
containsElement |
A coluna precisa conter pelo menos um dos valores na lista do filtro.
Válido apenas para colunas com tipos de dados de lista (como
Por exemplo, em um relatório |
variável |