ไวยากรณ์ของภาษาการค้นหาของ Google Ads

หน้านี้มีข้อมูลอ้างอิงไวยากรณ์ของภาษาการค้นหาของ Google Ads ดูรายละเอียดโครงสร้างการค้นหาได้ที่โครงสร้างการค้นหา

การอ้างอิงไวยากรณ์

การอ้างอิงไวยากรณ์ของภาษาการค้นหาของ 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 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 และต้องละเว้น เมื่อค้นหา GoogleAdsFieldService

  • WhereClause รองรับการรวมเงื่อนไขกับ AND เท่านั้น ไม่รองรับตรรกะ OR โปรดใช้โอเปอเรเตอร์ IN หรือ REGEXP_MATCH แทน

  • ตัวดำเนินการ REGEXP_MATCH ใช้ไวยากรณ์ RE2

  • หากต้องการจับคู่ [, ], % หรือ _ ตามตัวอักษรโดยใช้ตัวดำเนินการ LIKE ให้ใส่อักขระในวงเล็บเหลี่ยม ตัวอย่างเช่น เงื่อนไขต่อไปนี้จะตรงกับ ค่า campaign.name ทั้งหมดที่ขึ้นต้นด้วย [Earth_to_Mars]

    campaign.name LIKE '[[]Earth[_]to[_]Mars[]]%'
    
  • โอเปอเรเตอร์ LIKE ใช้ได้กับฟิลด์สตริงเท่านั้น ไม่ใช่อาร์เรย์