A nova API Search Ads 360 Reporting já está disponível. Participe do grupo do Google
searchads-api-announcements para ficar por dentro das próximas melhorias e versões.
Referência de gramática
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A tabela abaixo contém uma referência completa da gramática da linguagem de consulta do Search Ads 360.
| Referência de gramática |
| 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, coloque o caractere entre colchetes. Por exemplo, a condição a seguir corresponde a todos os valores campaign.name que começam com [Earth_to_Mars]:
WHERE campaign.name LIKE '[[]Earth[_]to[_]Mars[]]%'
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-29 UTC.
[null,null,["Última atualização 2025-08-29 UTC."],[],["The Search Ads 360 Query Language grammar includes clauses like `SELECT`, `FROM`, `WHERE`, `ORDER BY`, `LIMIT`, and `PARAMETERS`. It defines field, resource, and operator types, allowing queries to select data, specify the source, filter results, order them, and limit the output. Conditions are built with `FIELD_NAME`, `OPERATOR`, and `VALUE`. Values can be literals, numbers, strings, or lists. The grammar includes operators like `=`, `!=`, `\u003e`, `IN`, `LIKE`, and `REGEXP_MATCH` for comparisons.\n"]]