في ما يلي نموذج طلب بحث عن ProductPerformanceView
يعرض أداء حسابك خلال آخر 30 يومًا، مقسّمًا حسب marketingMethod
وofferId
. يمكنك تجربة هذا المثال السريع للتعرّف
على واجهة برمجة تطبيقات Merchant Reports API.
يجب أن يكون لديك دور الأداء والإحصاءات لاسترداد هذا التقرير. اطّلِع على المتطلبات لمزيد من التفاصيل.
لتقديم الطلب، مرِّر عبارة لغة طلب البحث في Merchant Center التالية إلى الطريقة
accounts.reports.search
:
SELECT
marketingMethod,
offerId,
impressions,
clicks,
clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2020-11-01' AND '2020-11-30'
عنوان URL لطلب HTTP
يتألف الطلب من طريقة POST لبروتوكول HTTP إلى خادم واجهة برمجة تطبيقات تقارير التجار على عنوان URL التالي:
https://merchantapi.googleapis.com/reports/v1beta/accounts/parent/reports:search
نموذج إكمال طلب HTTP
في ما يلي مثال كامل يعرض تعريف التقرير المضمّن في طلب HTTP POST:
POST /reports/v1beta/accounts/parent/reports:search HTTP/1.1 Host: merchantapi.googleapis.com User-Agent: curl Content-Type: application/json Accept: application/json Authorization: Bearer Parameters: { "query" : "SELECT marketingMethod, offerId, impressions, clicks, clickThroughRate FROM ProductPerformanceView WHERE date BETWEEN '2020-11-01' AND '2020-11-30'" }
إليك نموذج إجابة:
{
"results": [
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12345",
"clicks": "38",
"impressions": "1038",
"clickThroughRate": "0.3661"
}
},
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12346",
"clicks": "126",
"impressions": "1126",
"clickThroughRate": "0.1119"
}
},
{
"productPerformanceView": {
"marketingMethod": "ORGANIC",
"offerId": "12346",
"clicks": "26",
"impressions": "526",
"clickThroughRate": "0.0494"
}
},
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12347",
"clicks": "227",
"impressions": "1227",
"clickThroughRate": "0.1850"
}
},
{
"productPerformanceView": {
"marketingMethod": "ORGANIC",
"offerId": "12347",
"clicks": "12",
"impressions": "512",
"clickThroughRate": "0.0234"
}
}
]
}