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.
O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.
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"]]