این صفحه حاوی مرجع دستور زبان Google Ads Query Language است. برای جزئیات ساختار پُرسمان، ساختار پُرسمان را ببینید.
مرجع دستور زبان
در اینجا مرجع دستور زبان «زبان پُرسمان 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
?نشاندهنده عنصر اختیاری است.*یعنی صفر یا بیشتر؛+یعنی یک یا بیشتر.(...)نشاندهنده گروهبندی است، درحالیکه"("و")"نشاندهنده پرانتزهای واقعی است.[a-z0-9]نشاندهنده محدوده نویسه است و[^...]نشاندهنده هر نویسهای بهجز نویسههای فهرستشده است.|بهمعنی «یا» است.
قوانین و محدودیتها
هنگام پُرسمان
GoogleAdsService،FromClauseلازم است و هنگام پُرسمانGoogleAdsFieldServiceباید حذف شود.WhereClauseفقط از ترکیب شرایط باANDپشتیبانی میکند. ازORمنطقی پشتیبانی نمیشود؛ درعوض از عملگرINیاREGEXP_MATCHاستفاده کنید.اپراتور
REGEXP_MATCHاز نحو RE2 استفاده میکند.برای مطابقت دادن
[،]،%، یا_تحتاللفظی بااستفاده از عاملLIKE، نویسه را در قلاب قرار دهید. برای مثال، شرط زیر با همه مقادیرcampaign.nameکه با[Earth_to_Mars]شروع میشوند مطابقت دارد:campaign.name LIKE '[[]Earth[_]to[_]Mars[]]%'از عملگر
LIKEفقط میتوان در فیلد رشته استفاده کرد، نه در آرایه.