ต่อไปนี้เป็นการอ้างอิงไวยากรณ์ภาษาการค้นหาของ Google Ads (ในรูปแบบนิพจน์ทั่วไป)
Query -> SelectClause FromClause WhereClause? OrderByClause?
LimitClause? ParametersClause?
SelectClause -> SELECT FieldName (, FieldName)*
FromClause -> FROM ResourceName
WhereClause -> WHERE Condition (AND Condition)*
OrderByClause -> ORDER BY Ordering (, Ordering)*
LimitClause -> LIMIT PositiveInteger
ParametersClause -> PARAMETERS Literal = Value (, Literal = Value)*
Condition -> FieldName Operator Value
Operator -> = | != | > | >= | < | <= | IN | NOT IN |
LIKE | NOT LIKE | CONTAINS ANY | CONTAINS ALL |
CONTAINS NONE | IS NULL | IS NOT NULL | DURING |
BETWEEN | REGEXP_MATCH | NOT REGEXP_MATCH
Value -> Literal | LiteralList | Number | NumberList | String |
StringList | Function
Ordering -> FieldName (ASC | DESC)?
FieldName -> [a-z] ([a-zA-Z0-9._])*
ResourceName -> [a-z] ([a-zA-Z_])*
StringList -> ( String (, String)* )
LiteralList -> ( Literal (, Literal)* )
NumberList -> ( Number (, Number)* )
PositiveInteger -> [1-9] ([0-9])*
Number -> -? [0-9]+ (. [0-9] [0-9]*)?
String -> (' Char* ') | (" Char* ")
Literal -> [a-zA-Z0-9_]*
Function -> 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
?หมายถึงองค์ประกอบที่ไม่บังคับ
* หมายถึง 0 ขึ้นไป + หมายถึงอย่างน้อย 1 กลุ่ม
(xxxxxx) หมายถึงการจัดกลุ่ม
[a-z0-9] หมายถึงช่วงอักขระ
| ย่อมาจาก "or"
กฎและข้อจำกัด
โอเปอเรเตอร์
REGEXP_MATCHใช้ไวยากรณ์ RE2หากต้องการจับคู่อักขระตามตัวอักษร
[,],%หรือ_โดยใช้โอเปอเรเตอร์LIKEให้ล้อมรอบอักขระในวงเล็บเหลี่ยม เช่น เงื่อนไขต่อไปนี้ตรงกับค่าcampaign.nameทั้งหมดที่ขึ้นต้นด้วย[Earth_to_Mars]campaign.name LIKE '[[]Earth[_]to[_]Mars[]]%'โอเปอเรเตอร์
LIKEใช้ได้กับช่องสตริงเท่านั้น และใช้ได้ในอาร์เรย์