مثال

في ما يلي نموذج طلب بحث إلى MerchantPerformanceView يعرض أداء حسابك خلال آخر 30 يومًا، مقسّمًا حسب program وoffer_id. يمكنك تجربة هذا المثال السريع للتعرّف على خدمة Reports.

يجب أن تتولّى دور مدير التقارير لاسترداد هذا التقرير.

لتقديم الطلب، مرِّر عبارة "لغة طلب البحث في Merchant Center" التالية إلى طريقة reports.search:

SELECT
  segments.program,
  segments.offer_id,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'

تشغيل

انقر على تنفيذ لتجربة العيّنة في مستكشف واجهات برمجة التطبيقات. بعد النقر على تنفيذ، عدِّل عنصر نائب معرّف التاجر إلى معرّف التاجر الخاص بك في عنوان URL للطلب. يمكنك تعديل طلب البحث. يجب أن يبقى الاستعلام الكامل على سطر واحد لكي يعمل مع مستكشف واجهة برمجة التطبيقات.

عنوان URL لطلب HTTP

يتألف الطلب من طلب HTTP POST إلى خادم Content API for Shopping على عنوان URL التالي:

https://shoppingcontent.googleapis.com/content/v2.1/merchantId/reports/search

مثال على طلب HTTP كامل

في ما يلي مثال كامل يعرض تعريف التقرير أعلاه مضمّنًا في طلب HTTP POST:

POST /v2.1/merchantId/reports/search HTTP/1.1
Host: shoppingcontent.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer access token

Parameters:
{
  "query" : "SELECT segments.program, segments.offer_id, metrics.impressions,
                    metrics.clicks, metrics.ctr
            FROM MerchantPerformanceView
            WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'"
}