مثال

في ما يلي نموذج طلب بحث عن 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'

تشغيل

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

ملاحظة: يعرض هذا الدليل طلب HTTP الأساسي كأداة تعليمية، ولكننا ننصحك باستخدام إحدى مكتبات العملاء لإرسال طلباتك.

عنوان 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'"
}