تحتوي هذه الصفحة على مرجع لقواعد Google Ads Query Language. للاطّلاع على تفاصيل بنية طلب البحث، يُرجى الرجوع إلى بنية طلب البحث.
مرجع القواعد النحوية
في ما يلي مرجع لقواعد "لغة طلبات البحث في إعلانات Google" (بتنسيق التعابير العادية):
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]إلى نطاقات الأحرف، ويشير[^...]إلى أي حرف باستثناء الأحرف المدرَجة. - يمثّل
|"أو".
القواعد والقيود
يجب إدخال قيمة
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إلا في حقل سلسلة، وليس في مصفوفة.