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_NAMEOPERATORVALUE
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
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]:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Ú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"]]