بنية طلب البحث

يمكن إرسال طلبات البحث لحقلَي المقاييس والشرائح إلى reports.search . لإنشاء طلب بحث بلغة طلب البحث في Merchant Center، يجب أولاً إنشاء باستخدام قواعد اللغة. يتكون الاستعلام من عدد من العبارات:

  • SELECT
  • FROM
  • WHERE
  • ORDER BY
  • LIMIT

تستخدم البنود أسماء الحقول وأسماء الجداول وعوامل التشغيل والشروط الترتيبات لمساعدتك في تحديد البيانات المطلوبة. بعد دمجها في حملة واحدة ، يمكن تقديم طلب باستخدام Google Content API for Shopping. دعونا نلقي نظرة على كيفية عمل كل منها التي يمكن استخدامها.

البنود

SELECT

تحدّد العبارة SELECT مجموعة من الحقول المطلوب استرجاعها في الطلب. SELECT تأخذ قائمة مفصولة بفواصل لحقول الأقسام والمقاييس، وتعرض القيم في الرد. عبارة SELECT مطلوبة في طلب البحث.

في ما يلي نموذج طلب بحث يختار مقاييس النقرات من جدول معيّن:

SELECT
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31

يمكنك أيضًا الاستعلام عن أنواع حقول مختلفة في طلب واحد:

SELECT
  segments.date,
  segments.program,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31
  • حقول الشرائح

    • segments.date
    • segments.program
  • المقاييس

    • metrics.impressions
    • metrics.clicks

لا يُسمح ببعض الحقول في عبارة SELECT بسبب ما يلي: التقييد:

  • جارٍ الاستعلام عن حقول الشريحة التي لا تحتوي على حقل مقياس واحد على الأقل.

يمكنك الاطّلاع على المعلومات المتعلّقة بالشرط أعلاه في مستنداتنا المرجعية.

FROM

تحدد العبارة FROM الجدول المطلوب استرجاع البيانات منه في الطلب. تشير رسالة الأشكال البيانية في عبارة FROM، أي الحقول التي يمكن استخدامها من قِبل جميع الأنواع الأخرى العبارات للاستعلام المحدد. يمكن تحديد جدول واحد فقط في FROM. في الوقت الحالي، يمكن استخدام جدول Merchant PerformanceView فقط. العبارة FROM مطلوبة في طلب البحث للطريقة search في خدمة reports.

أين؟

تحدّد العبارة WHERE الشروط التي يجب تطبيقها عند فلترة البيانات حسب طلبك. عند استخدام عبارة WHERE، يمكن تحديد شرط واحد أو أكثر. نستخدم AND للفصل بينها. يجب أن يتبع كل شرط النمط field_name Operator value يمكن استخدام أي حقل شرائح في WHERE. ولكن يجب تحديد حقول المقاييس في عبارة SELECT لتكون في البند WHERE. عبارة WHERE مطلوبة في طلب بحث، لأنه يجب عليك دائمًا تحديد النطاق الزمني الذي تريد عرض بيانات الأداء.

في ما يلي مثال على استخدام WHERE لعرض مقاييس في وقت معيّن. المدة:

SELECT
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31

يمكنك الجمع بين شروط متعددة لفلترة البيانات. سيعرض هذا المثال عدد النقرات لكل عرض في برنامج SHOPPING_ADS، حيث تتجاوز النقرات > 100 خلال فترة الـ 30 يومًا المحددة.

SELECT
  segments.offer_id,
  segments.program,
  metrics.clicks
FROM MerchantPerformanceView
WHERE metrics.clicks > 100
  AND segments.program = SHOPPING_ADS
  AND segments.date BETWEEN 2020-08-01 AND 2020-08-31;

في طلب البحث التالي، ستلاحظ أنه تم اختيار segments.date. بغض النظر عما إذا كنت قد اخترت segments.date، سيتم استخدام نطاق زمني محدود في يجب دائمًا توفير عبارة WHERE لاسترداد بيانات الأداء.

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31

عند الفلترة، من المهم مراعاة حساسية حالة الأحرف بالنسبة إلى عامل التشغيل الذهن.

للحصول على قائمة كاملة بعوامل التشغيل، يُرجى الرجوع إلى قواعد اللغة

ORDER BY

تحدّد العبارة ORDER BY الترتيب الذي ستظهر به النتائج. عاد. يتيح لك ذلك ترتيب البيانات تصاعديًا أو تنازليًا بناءً على اسم الحقل. يتم تحديد كل طلب على أنّه field_name متبوعًا ASC أو DESC. إذا لم يتم تحديد ASC أو DESC، سيتم ضبط الطلب تلقائيًا. إلى ASC. يمكن استخدام الحقول المحدّدة في عبارة SELECT فقط في ORDER BY. تعتبر عبارة ORDER BY اختيارية في الاستعلام.

يقوم الاستعلام التالي بترتيب الصفوف المعروضة حسب عدد النقرات من الأعلى إلى الأدنى:

SELECT
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31
ORDER BY metrics.clicks DESC

يمكنك تحديد حقول متعددة في عبارة ORDER BY باستخدام مفصولة بفواصل. الحالية. سيحدث الترتيب بالتسلسل نفسه المحدد في طلب البحث. على سبيل المثال، في هذا الاستعلام، سيتم فرز النتائج بترتيب تصاعدي حسب offer_id، ثم بترتيب تنازلي حسب عدد مرات الظهور، ثم ترتيبًا تنازليًا حسب عدد النقرات:

SELECT
  segments.offer_id,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31
ORDER BY
  segments.offer_id,
  metrics.impressions DESC,
  metrics.clicks DESC

LIMIT

تسمح لك عبارة LIMIT بتحديد عدد النتائج المطلوب عرضها. ويكون هذا مفيدًا إذا كنت مهتمًا فقط بالملخص.

على سبيل المثال، يمكن استخدام LIMIT لتقييد إجمالي عدد نتائج الاستعلام التالي:

SELECT
  segments.program,
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31
ORDER BY metrics.impressions DESC
LIMIT 50