أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

مرجع قواعد طلب البحث

يحتوي الجدول التالي على مرجع كامل لقواعد لغة طلبات البحث في "إعلانات شبكة البحث 360".

مرجع نحوي

طلب البحث

`SELECT` عبارة	SELECT `FIELD_NAME` (, `FIELD_NAME`)*
`FROM` عبارة	FROM `RESOURCE_NAME`
`WHERE` عبارة	WHERE `CONDITION` (AND `CONDITION`)*
`ORDER BY` عبارة	ORDER BY `ORDERING` (, `ORDERING`)*
`LIMIT` عبارة	LIMIT `POSITIVE_INTEGER`
`PARAMETERS` عبارة	PARAMETERS `LITERAL` = `VALUE` (, `LITERAL` = `VALUE`)*

اسم الحقل

[a-z] ([a-zA-Z0-9._])*

اسم المورد

[a-z] ([a-zA-Z_])*

الشرط FIELD_NAME OPERATOR VALUE

الترتيب

FIELD_NAME (ASC | DESC)?

مُشغِّل

= | != | > | >= | < | <= | IN | NOT IN | LIKE | NOT LIKE | CONTAINS ANY |
CONTAINS ALL | CONTAINS NONE | IS NULL | IS NOT NULL | DURING | BETWEEN |
REGEXP_MATCH | NOT REGEXP_MATCH

الوظيفة

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

القيمة

LITERAL | LITERAL_LIST | NUMBER | NUMBER_LIST | STRING | STRING_LIST | FUNCTION

عدد صحيح موجب

[1-9] ([0-9])*

العدد

-? [0-9]+ (. [0-9] [0-9]*)?

سلسلة

(' Char* ') | (" Char* ")

حرفي

[a-zA-Z0-9_]*

قائمة السلاسل

( STRING (, STRING)* )

قائمة الحروف

( LITERAL (, LITERAL)* )

قائمة الأرقام

( NUMBER (, NUMBER)* )

المفتاح:

يشير الرمز ? إلى عنصر اختياري.
‫* تعني صفر أو أكثر
يشير الرمز + إلى واحد أو أكثر.
يشير الرمز (xxxxxx) إلى تجميع.
يشير الرمز [a-z0-9] إلى نطاق أحرف.
يشير الرمز Char إلى أي حرف.
يشير الرمز | إلى "أو".
يستخدم عامل التشغيل REGEXP_MATCH بنية RE2.
لمطابقة القيمة الحرفية [ أو ] أو % أو _ باستخدام عامل التشغيل LIKE، احط الحرف بأقواس مربّعة. على سبيل المثال، يتطابق الشرط التالي مع جميع قيم campaign.name التي تبدأ بـ [Earth_to_Mars]:
```
WHERE campaign.name LIKE '[[]Earth[_]to[_]Mars[]]%'
```