Documentation de référence sur la grammaire des requêtes

Le tableau ci-dessous contient une documentation de référence complète sur la grammaire du langage de requête Search Ads 360.

Référence grammaticale
Requête
Clause SELECT 
SELECT FIELD_NAME (, FIELD_NAME)*
Clause FROM 
FROM RESOURCE_NAME
Clause WHERE 
WHERE CONDITION (AND CONDITION)*
Clause ORDER BY 
ORDER BY ORDERING (, ORDERING)*
Clause LIMIT 
LIMIT POSITIVE_INTEGER
Clause PARAMETERS 
PARAMETERS LITERAL = VALUE (, LITERAL = VALUE)*
Nom du champ 
[a-z] ([a-zA-Z0-9._])*
Nom de la ressource 
[a-z] ([a-zA-Z_])*
Condition FIELD_NAME OPERATOR VALUE
Classement 
FIELD_NAME (ASC | DESC)?
Opérateur 
= | != | > | >= | < | <= | IN | NOT IN | LIKE | NOT LIKE | CONTAINS ANY |
CONTAINS ALL | CONTAINS NONE | IS NULL | IS NOT NULL | DURING | BETWEEN |
REGEXP_MATCH | NOT REGEXP_MATCH
Fonction 
LAST_14_DAYS | LAST_30_DAYS | LAST_7_DAYS | LAST_BUSINESS_WEEK | LAST_MONTH |
LAST_WEEK_MON_SUN | LAST_WEEK_SUN_SAT | THIS_MONTH | THIS_WEEK_MON_TODAY |
THIS_WEEK_SUN_TODAY | TODAY | YESTERDAY
Valeur 
LITERAL | LITERAL_LIST | NUMBER | NUMBER_LIST | STRING | STRING_LIST | FUNCTION
Nombre entier positif 
[1-9] ([0-9])*
Nombre 
-? [0-9]+ (. [0-9] [0-9]*)?
Chaîne 
(' Char* ') | (" Char* ")
Littéral 
[a-zA-Z0-9_]*
Liste de chaînes 
( STRING (, STRING)* )
Liste littérale 
( LITERAL (, LITERAL)* )
Liste de nombres 
( NUMBER (, NUMBER)* )

Clé :

  • ? indique un élément facultatif.
  • * signifie zéro ou plusieurs
  • + signifie un ou plusieurs.
  • (xxxxxx) indique un regroupement.
  • [a-z0-9] indique une plage de caractères.
  • Char indique n'importe quel caractère.
  • | signifie "ou".
  • L'opérateur REGEXP_MATCH utilise la syntaxe RE2.

  • Pour faire correspondre un littéral [, ], % ou _ à l'aide de l'opérateur LIKE, placez le caractère entre crochets. Par exemple, la condition suivante correspond à toutes les valeurs campaign.name commençant par [Earth_to_Mars]:

    WHERE campaign.name LIKE '[[]Earth[_]to[_]Mars[]]%'