في ما يلي مرجع قواعد لغة طلب البحث في إعلانات 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 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
?تشير إلى عنصر اختياري
تشير السمة * إلى صفر أو أكثر؛ + تعني واحد أو أكثر
يشير (xxxxxx) إلى مجموعة
يشير [a-z0-9] إلى نطاقات الأحرف
يشير الاختصار | إلى "أو"
لمطابقة قيمة حرفية [ أو ] أو % أو _ باستخدام عامل التشغيل LIKE، اضغط على
الحرف بين قوسين مربعين. على سبيل المثال، يتطابق الشرط التالي
كل قيم campaign.name التي تبدأ بـ [Earth_to_Mars]:
campaign.name LIKE '[[]Earth[_]to[_]Mars[]]%'
يمكن استخدام عامل التشغيل LIKE في حقل سلسلة فقط، وليس في مصفوفة.
تاريخ التعديل الأخير: 2024-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Google Ads Query Language (GAQL) uses a specific syntax to construct queries for retrieving data from Google Ads accounts, similar to SQL."],["GAQL supports various clauses like `SELECT`, `FROM`, `WHERE`, `ORDER BY`, `LIMIT`, and `PARAMETERS` for data manipulation."],["The `WHERE` clause allows filtering data based on conditions using operators like `=`, `!=`, `\u003e`, `\u003c`, `IN`, `LIKE`, `CONTAINS`, and others."],["GAQL provides built-in functions such as `LAST_14_DAYS`, `THIS_MONTH`, `TODAY`, etc., for convenient date range selection within queries."],["When using operators like `LIKE`, special characters need to be escaped with square brackets for literal matching."]]],[]]