Par défaut, votre rapport contient toutes les données du champ d'application reportScope spécifié par votre requête. Si vous souhaitez qu'un rapport ne contienne que les données correspondant à un ensemble de critères, vous pouvez y ajouter un ou plusieurs filtres. Seules les lignes correspondant à tous les filtres sont renvoyées.
Par exemple, vous pouvez demander un rapport sur tous les mots clés d'une agence. Vous pouvez ensuite spécifier un filtre afin que seuls les mots clés dont les URL de page de destination commencent par "www.example.com" et "www.autre-example.com" apparaissent dans le rapport.
"filters": [ { "column" : { "columnName": "keywordLandingPage" }, "operator" : "startsWith", "values" : [ "http://www.example.com", "http://www.another-example.com" ] } ]
Chaque filtre spécifie une colonne à filtrer, un opérateur et une liste de valeurs censées figurer dans la colonne spécifiée:
"filters": [ { "column" : column to filter on, "operator" : operator specifying the type of filter, "values" : list of values }, { ... another filter can go here ... } ]
Filterable
.
Opérateurs de filtres
Tous les filtres sont sensibles à la casse. Autrement dit, un filtre avec "www.Sprockets.com" ne correspondra pas à une colonne contenant "www.sprockets.com".
Opérateur | Description | Nombre de valeurs acceptées |
---|---|---|
equals |
La colonne doit correspondre exactement à la valeur spécifiée. | 1 |
notEquals |
La colonne ne doit pas correspondre à la valeur spécifiée. | 1 |
in |
La colonne doit correspondre exactement à l'une des valeurs figurant dans la liste du filtre.
Non valide pour les types de données de liste (tels que |
variable |
lessThan |
La colonne doit contenir une valeur inférieure à la valeur spécifiée.
Si vous spécifiez ce filtre pour une colonne Non valide pour les types de données de liste (tels que |
1 |
greaterThan |
La colonne doit contenir une valeur supérieure à l'une des valeurs de la liste du filtre.
Si vous spécifiez ce filtre pour une colonne
Non valide pour les types de données de liste (tels que |
1 |
lessThanOrEqual |
La colonne doit contenir une valeur inférieure ou égale à l'une des valeurs de la liste du filtre.
Si vous spécifiez ce filtre pour une colonne
Non valide pour les types de données de liste (tels que |
1 |
greaterThanOrEqual |
La colonne doit contenir une valeur supérieure ou égale à l'une des valeurs de la liste du filtre.
Si vous spécifiez ce filtre pour une colonne
Non valide pour les types de données de liste (tels que |
1 |
isNull |
La colonne doit être vide. Par exemple, si vous spécifiez isNull pour la colonne keywordMaxCpc d'un rapport sur les mots clés, le rapport ne contiendra que les mots clés sans CPC max.
|
0 |
isNotNull |
La colonne doit contenir une valeur. | 0 |
startsWith |
La colonne doit commencer par l'une des chaînes de la liste du filtre.
Valide uniquement pour les colonnes |
variable |
containsSubstring |
La colonne doit contenir tout ou partie de l'une des chaînes spécifiées dans la liste du filtre.
Par exemple, un filtre
mais ne renverra pas les lignes contenant les valeurs suivantes:
Valide uniquement pour les colonnes |
variable |
doesNotContainSubstring |
La colonne ne doit contenir aucune des chaînes de la liste du filtre.
Par exemple, un filtre mais ne renvoie pas les lignes contenant les valeurs suivantes:
Valide uniquement pour les colonnes |
variable |
containsElement |
La colonne doit contenir au moins une des valeurs figurant dans la liste du filtre.
Uniquement valide pour les colonnes dont les types de données sont des listes (par exemple,
Par exemple, dans un rapport |
variable |