Referência de gramática

A tabela abaixo contém uma gramática completa da linguagem de consulta do Search Ads 360 de referência.

Referência gramatical
Consulta
Cláusula SELECT 
SELECT FIELD_NAME (, FIELD_NAME)*
Cláusula FROM 
FROM RESOURCE_NAME
Cláusula WHERE 
WHERE CONDITION (AND CONDITION)*
Cláusula ORDER BY 
ORDER BY ORDERING (, ORDERING)*
Cláusula LIMIT 
LIMIT POSITIVE_INTEGER
Cláusula PARAMETERS 
PARAMETERS LITERAL = VALUE (, LITERAL = VALUE)*
Nome do campo 
[a-z] ([a-zA-Z0-9._])*
Nome do recurso 
[a-z] ([a-zA-Z_])*
Condição FIELD_NAME OPERATOR VALUE
Pedidos 
FIELD_NAME (ASC | DESC)?
Operador 
= | != | > | >= | < | <= | IN | NOT IN | LIKE | NOT LIKE | CONTAINS ANY |
CONTAINS ALL | CONTAINS NONE | IS NULL | IS NOT NULL | DURING | BETWEEN |
REGEXP_MATCH | NOT REGEXP_MATCH
Função 
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
Valor 
LITERAL | LITERAL_LIST | NUMBER | NUMBER_LIST | STRING | STRING_LIST | FUNCTION
Número inteiro positivo 
[1-9] ([0-9])*
Número 
-? [0-9]+ (. [0-9] [0-9]*)?
String 
(' Char* ') | (" Char* ")
Literal 
[a-zA-Z0-9_]*
Lista de strings 
( STRING (, STRING)* )
Lista literal 
( LITERAL (, LITERAL)* )
Lista de números 
( NUMBER (, NUMBER)* )

Chave:

  • ? indica um elemento opcional.
  • * significa zero ou mais
  • + significa um ou mais.
  • (xxxxxx) indica um agrupamento.
  • [a-z0-9] indica um intervalo de caracteres.
  • Char indica qualquer caractere.
  • | significa "ou".
  • O operador REGEXP_MATCH usa a sintaxe RE2.

  • Para corresponder a um literal [, ], % ou _ usando o operador LIKE, envolva o caractere entre colchetes. Por exemplo, a condição a seguir corresponde todos os valores campaign.name que começam com [Earth_to_Mars]:

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