مثال

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

يجب أن يكون لديك دور "مدير إعداد التقارير" لاسترداد هذا التقرير.

لتقديم الطلب، عليك تمرير ملف Merchant Center Query Language statement التالي إلى reports.search method:

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'"
}
السابق
نظرة عامة
التالي
قياس الأداء