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
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
, inclua
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 2024-11-24 UTC.
[null,null,["Última atualização 2024-11-24 UTC."],[[["This document provides a comprehensive grammar reference for the Search Ads 360 Query Language."],["The language allows users to query data using a structured syntax including clauses like `SELECT`, `FROM`, `WHERE`, `ORDER BY`, `LIMIT`, and `PARAMETERS`."],["Various data types like numbers, strings, and lists are supported within the query structure for filtering and data retrieval."],["Specific operators and functions enable detailed data manipulation, such as date ranges (`LAST_30_DAYS`) and pattern matching (`REGEXP_MATCH`)."],["The provided table details the syntax and components of the query language, along with explanations of special characters and usage examples."]]],[]]