أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google
searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.
مرجع قواعد طلب البحث
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يحتوي الجدول التالي على مرجع كامل لقواعد لغة طلبات البحث في "إعلانات شبكة البحث 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)* ) |
المفتاح:
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis document provides a comprehensive grammar reference for the Search Ads 360 Query Language.\u003c/p\u003e\n"],["\u003cp\u003eThe language allows users to query data using a structured syntax including clauses like \u003ccode\u003eSELECT\u003c/code\u003e, \u003ccode\u003eFROM\u003c/code\u003e, \u003ccode\u003eWHERE\u003c/code\u003e, \u003ccode\u003eORDER BY\u003c/code\u003e, \u003ccode\u003eLIMIT\u003c/code\u003e, and \u003ccode\u003ePARAMETERS\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eVarious data types like numbers, strings, and lists are supported within the query structure for filtering and data retrieval.\u003c/p\u003e\n"],["\u003cp\u003eSpecific operators and functions enable detailed data manipulation, such as date ranges (\u003ccode\u003eLAST_30_DAYS\u003c/code\u003e) and pattern matching (\u003ccode\u003eREGEXP_MATCH\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eThe provided table details the syntax and components of the query language, along with explanations of special characters and usage examples.\u003c/p\u003e\n"]]],["The Search Ads 360 Query Language grammar includes clauses like `SELECT`, `FROM`, `WHERE`, `ORDER BY`, `LIMIT`, and `PARAMETERS`. It defines field, resource, and operator types, allowing queries to select data, specify the source, filter results, order them, and limit the output. Conditions are built with `FIELD_NAME`, `OPERATOR`, and `VALUE`. Values can be literals, numbers, strings, or lists. The grammar includes operators like `=`, `!=`, `\u003e`, `IN`, `LIKE`, and `REGEXP_MATCH` for comparisons.\n"],null,[]]