مثال

إليك نموذج طلب بحث خاص بـ 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

يتألف الطلب من طلب POST لـ HTTP إلى خادم 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'"
}