หน้านี้มีการอ้างอิงไวยากรณ์ของ Google Ads Query Language ดูรายละเอียดโครงสร้างคําค้นหาได้ที่ โครงสร้างคําค้นหา
การอ้างอิงไวยากรณ์
ต่อไปนี้คือการอ้างอิงไวยากรณ์ของ Google Ads Query Language (ในรูปแบบนิพจน์ทั่วไป)
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 IS NULL
| FieldName IS NOT NULL
| FieldName BETWEEN Value AND Value
| FieldName Operator Value
Operator -> "=" | "!=" | ">" | ">=" | "<" | "<=" | IN | NOT IN
| LIKE | NOT LIKE | CONTAINS ANY | CONTAINS ALL
| CONTAINS NONE | DURING
| 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-Z0-9_])*
StringList -> "(" String ("," String)* ")"
LiteralList -> "(" Literal ("," Literal)* ")"
NumberList -> "(" Number ("," Number)* ")"
PositiveInteger -> [1-9]([0-9])*
Number -> -?[0-9]+(\.[0-9]+)?
String -> ("'" SingleQuoteChar* "'") | ('"' DoubleQuoteChar* '"')
SingleQuoteChar -> [^'\\\r\n] | EscapeSequence
DoubleQuoteChar -> [^"\\\r\n] | EscapeSequence
EscapeSequence -> "\\" ("\\" | "'" | '"' | "n" | "r" | "t")
Literal -> [a-zA-Z]([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 รายการขึ้นไป(...)หมายถึงการจัดกลุ่ม ส่วน"("และ")"หมายถึงวงเล็บตามตัวอักษร[a-z0-9]หมายถึงช่วงอักขระ และ[^...]หมายถึงอักขระใดๆ ยกเว้นอักขระที่ระบุ|หมายถึง "หรือ"
กฎและข้อจำกัด
ต้องระบุ
FromClauseเมื่อค้นหาGoogleAdsServiceและต้องละเว้นเมื่อค้นหาGoogleAdsFieldServiceWhereClauseรองรับการรวมเงื่อนไขด้วยANDเท่านั้น ไม่รองรับORเชิงตรรกะ ให้ใช้โอเปอเรเตอร์INหรือREGEXP_MATCHแทนโอเปอเรเตอร์
REGEXP_MATCHใช้ ไวยากรณ์ RE2หากต้องการจับคู่
[,],%หรือ_ตามตัวอักษรโดยใช้โอเปอเรเตอร์LIKEให้ใส่เครื่องหมายดังกล่าวไว้ในวงเล็บเหลี่ยม ตัวอย่างเช่น เงื่อนไขต่อไปนี้จะจับคู่ค่าcampaign.nameทั้งหมดที่ขึ้นต้นด้วย[Earth_to_Mars]campaign.name LIKE '[[]Earth[_]to[_]Mars[]]%'โอเปอเรเตอร์
LIKEใช้ได้กับช่องสตริงเท่านั้น ไม่ใช่อาร์เรย์