أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك "لغة طلبات البحث في إعلانات شبكة البحث 360" تحديد النطاق الزمني بطريقتَين:
نطاق زمني مخصّص
نطاق زمني محدّد مسبقًا
نطاق زمني مخصص
يمكنك تحديد التواريخ بالتنسيق ISO 8601(YYYY-MM-DD):
segments.date BETWEEN '2019-01-01' AND '2019-01-31'
segments.date >= '2019-01-01' AND segments.date <= '2019-01-31'
الفترات الزمنية
تشير بعض حقول التاريخ إلى فترة زمنية محدّدة مسبقًا، وتحديدًا:
segments.week
segments.month
segments.quarter
عند الفلترة حسب هذه الشرائح، يمكنك استخدام عامل التشغيل = مع التاريخ الذي يمثّل اليوم الأول من الفترة الزمنية. اعتبارًا من الإصدار 9، إذا حدّدت تاريخًا
ليس اليوم الأول من الفترة، سيتم عرض الخطأ MISALIGNED_DATE_FOR_FILTER.
على سبيل المثال، لتحديد شهر أيار (مايو) في عام 2021، يمكنك استخدام الشرط التالي، مع تحديد اليوم الأول من ذلك الشهر:
segments.month = '2021-05-01'
نطاق زمني محدّد مسبقًا
في ما يلي قائمة بالنطاقات الزمنية الصالحة المحدّدة مسبقًا:
النطاق الزمني
يتم إنشاء التقارير لما يلي:
TODAY
اليوم فقط
YESTERDAY
الأمس فقط
LAST_7_DAYS
آخر 7 أيام باستثناء اليوم
LAST_BUSINESS_WEEK
أسبوع العمل السابق الذي يمتدّ لخمسة أيام، من الاثنين إلى الجمعة
تاريخ التعديل الأخير: 2025-09-03 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2025-09-03 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Search Ads 360 Query Language allows specifying date ranges using either custom dates or predefined date ranges.\u003c/p\u003e\n"],["\u003cp\u003eCustom date ranges can be defined using ISO 8601 format and operators like \u003ccode\u003eBETWEEN\u003c/code\u003e, \u003ccode\u003e>=\u003c/code\u003e, and \u003ccode\u003e<=\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eTime period segments such as week, month, and quarter require filtering with the first day of the period using the \u003ccode\u003e=\u003c/code\u003e operator.\u003c/p\u003e\n"],["\u003cp\u003ePredefined date ranges offer shortcuts for common periods like \u003ccode\u003eTODAY\u003c/code\u003e, \u003ccode\u003eLAST_7_DAYS\u003c/code\u003e, \u003ccode\u003eLAST_MONTH\u003c/code\u003e, and others, simplifying query construction.\u003c/p\u003e\n"],["\u003cp\u003eSpecifying a date that is not the first day of a period for segments like \u003ccode\u003esegments.month\u003c/code\u003e will result in a \u003ccode\u003eMISALIGNED_DATE_FOR_FILTER\u003c/code\u003e error.\u003c/p\u003e\n"]]],["The Search Ads 360 Query Language uses custom or predefined date ranges. Custom ranges utilize ISO 8601 format (YYYY-MM-DD) for specific dates (e.g., `segments.date BETWEEN '2019-01-01' AND '2019-01-31'`). For segments like `week`, `month`, or `quarter`, filters must use the first day of the period. Predefined ranges, such as `TODAY`, `LAST_7_DAYS`, or `LAST_MONTH`, offer shortcuts (e.g., `segments.date DURING LAST_30_DAYS`).\n"],null,[]]
