Por padrão, seu relatório conterá todos os dados dentro do reportScope que especificado pela solicitação. Se você quiser que um relatório contenha apenas os dados que correspondem a um conjunto de critérios, você pode adicionar um ou mais filtros a um relatório. Somente as linhas que atendem a todos os filtros são retornadas.
Por exemplo, é possível solicitar um relatório de todas as palavras-chave de uma agência. Depois, especifique um filtro para que somente as palavras-chave com URLs da página de destino que comecem com www.example.com e www.another-example.com aparecerão 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 correspondem 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 este filtro para uma coluna Não é válido para tipos de dados de lista (como |
1 |
greaterThan |
A coluna deve conter um valor maior que um dos valores em à 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 deve 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 deve 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, o relatório
conterá apenas 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álido apenas para colunas |
variável |
containsSubstring |
A coluna deve conter todas ou parte de uma das strings especificadas no na lista do filtro.
Por exemplo, um filtro
mas não retornaria linhas com estes valores:
Válido apenas para colunas |
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álido apenas para colunas |
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 |