Новый API отчетов Search Ads 360 теперь доступен. Присоединяйтесь к группе Google
searchads-api-announcements , чтобы быть в курсе предстоящих улучшений и выпусков.
Справочник по грамматике запросов
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
В таблице ниже содержится полный справочник по грамматике языка запросов Search Ads 360.
Справочник по грамматике |
---|
Запрос | предложение SELECT | SELECT FIELD_NAME (, FIELD_NAME)* | FROM предложения | FROM RESOURCE_NAME | Предложение WHERE | WHERE CONDITION (AND CONDITION)* | Предложение ORDER BY | ORDER BY ORDERING (, ORDERING)* | Предложение LIMIT | LIMIT POSITIVE_INTEGER | Пункт PARAMETERS | PARAMETERS LITERAL = VALUE (, LITERAL = VALUE)* |
|
Имя поля | [a-z] ([a-zA-Z0-9._])* |
Имя ресурса | [a-z] ([a-zA-Z_])* |
Состояние | FIELD_NAME VALUE OPERATOR |
Заказ | FIELD_NAME (ASC | DESC)? |
Оператор | = | != | > | >= | < | <= | IN | NOT IN | LIKE | NOT LIKE | CONTAINS ANY | CONTAINS ALL | CONTAINS NONE | IS NULL | IS NOT NULL | DURING | BETWEEN | REGEXP_MATCH | NOT REGEXP_MATCH |
Функция | 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 |
Ценить | LITERAL | LITERAL_LIST | NUMBER | NUMBER_LIST | STRING | STRING_LIST | FUNCTION |
Положительное целое число | [1-9] ([0-9])* |
Число | -? [0-9]+ (. [0-9] [0-9]*)? |
Нить | (' Char* ') | (" Char* ") |
Буквальный | [a-zA-Z0-9_]* |
Список строк | ( STRING (, STRING)* ) |
Список букв | ( LITERAL (, LITERAL)* ) |
Список номеров | ( NUMBER (, NUMBER)* ) |
Ключ:
-
?
указывает на необязательный элемент. -
*
означает ноль или более -
+
означает один или несколько. -
(xxxxxx)
указывает на группировку. -
[a-z0-9]
указывает диапазон символов. -
Char
указывает на любой символ. -
|
означает «или». - Оператор
REGEXP_MATCH
использует синтаксис RE2 . Чтобы сопоставить литерал [
, ]
, %
или _
с помощью оператора LIKE
, заключите символ в квадратные скобки. Например, следующее условие соответствует всем значениям campaign.name
, начинающимся с [Earth_to_Mars]
:
WHERE campaign.name LIKE '[[]Earth[_]to[_]Mars[]]%'
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-29 UTC.
[null,null,["Последнее обновление: 2025-08-29 UTC."],[[["\u003cp\u003eThis document provides a comprehensive grammar reference for the Search Ads 360 Query Language.\u003c/p\u003e\n"],["\u003cp\u003eThe language allows users to query data using a structured syntax including clauses like \u003ccode\u003eSELECT\u003c/code\u003e, \u003ccode\u003eFROM\u003c/code\u003e, \u003ccode\u003eWHERE\u003c/code\u003e, \u003ccode\u003eORDER BY\u003c/code\u003e, \u003ccode\u003eLIMIT\u003c/code\u003e, and \u003ccode\u003ePARAMETERS\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eVarious data types like numbers, strings, and lists are supported within the query structure for filtering and data retrieval.\u003c/p\u003e\n"],["\u003cp\u003eSpecific operators and functions enable detailed data manipulation, such as date ranges (\u003ccode\u003eLAST_30_DAYS\u003c/code\u003e) and pattern matching (\u003ccode\u003eREGEXP_MATCH\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eThe provided table details the syntax and components of the query language, along with explanations of special characters and usage examples.\u003c/p\u003e\n"]]],["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"],null,[]]