De forma predeterminada, tu informe contendrá todos los datos dentro de reportScope que que se especifica en tu solicitud. Si desea que un informe contenga solo los datos que coincidan con un conjunto puedes agregar uno o más filtros a un informe. Solo las filas que satisfacen todos los filtros un resultado de la consulta.
Por ejemplo, puede solicitar un informe de todas las palabras clave en una agencia. Después Puedes especificar un filtro para que solo las palabras clave con URLs de página de destino comiencen con www.example.com y www.otro-ejemplo.com aparecen en el informe.
"filters": [ { "column" : { "columnName": "keywordLandingPage" }, "operator" : "startsWith", "values" : [ "http://www.example.com", "http://www.another-example.com" ] } ]
Cada filtro especifica una columna para filtrar, un operador y una lista de valores que se espera que estén en la columna 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 los filtros distinguen mayúsculas de minúsculas. Es decir, un filtro con "www.Sprockets.com" no coincidirán una columna que contenga "www.sprockets.com"
Operador | Descripción | Cantidad de valores admitidos |
---|---|---|
equals |
La columna debe coincidir exactamente con el valor especificado. | 1 |
notEquals |
La columna no debe coincidir con el valor especificado. | 1 |
in |
La columna debe coincidir exactamente con uno de los valores de la lista del filtro.
No es válido para los tipos de datos de lista (como |
variable |
lessThan |
La columna debe contener un valor que sea menor que el valor especificado.
Si especificas este filtro para una columna No es válido para los tipos de datos de lista (como |
1 |
greaterThan |
La columna debe contener un valor que sea mayor que uno de los valores en la lista de filtros.
Si especificas este filtro para una columna
No es válido para los tipos de datos de lista (como |
1 |
lessThanOrEqual |
La columna debe contener un valor que sea menor o igual que uno de los valores en la lista del filtro.
Si especificas este filtro para una columna
No es válido para los tipos de datos de lista (como |
1 |
greaterThanOrEqual |
La columna debe contener un valor que sea mayor o igual que uno de los valores en la lista del filtro.
Si especificas este filtro para una columna
No es válido para los tipos de datos de lista (como |
1 |
isNull |
La columna debe estar vacía. Por ejemplo, si especificas isNull
para la columna keywordMaxCpc de un informe de palabras clave, el informe
contendrá solo las palabras clave que no especificaron un CPC máximo.
|
0 |
isNotNull |
La columna debe contener un valor. | 0 |
startsWith |
La columna debe comenzar con una de las cadenas de la lista del filtro.
Solo es válido para |
variable |
containsSubstring |
La columna debe contener la totalidad o parte de una de las cadenas especificadas en el en la lista de filtros.
Por ejemplo, un filtro
pero no mostraría filas con estos valores:
Solo es válido para |
variable |
doesNotContainSubstring |
La columna no debe contener ninguna de las cadenas de la lista de filtros.
Por ejemplo, un filtro pero no mostraría filas con estos valores:
Solo es válido para |
variable |
containsElement |
La columna debe contener al menos uno de los valores de la lista de filtros.
Solo es válido para columnas con tipos de datos de lista (como
Por ejemplo, en un informe |
variable |