يمكن إرسال طلبات البحث لحقلَي المقاييس والشرائح إلى 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