مثال

در اینجا یک جستجوی نمونه برای MerchantPerformanceView وجود دارد که عملکرد حساب شما را در 30 روز گذشته، تقسیم‌بندی شده بر اساس program و offer_id برمی‌گرداند. برای آشنایی با سرویس Reports می توانید این مثال سریع را امتحان کنید.

برای بازیابی این گزارش به نقش مدیر گزارش نیاز دارید.

برای ارسال درخواست، عبارت Merchant Center Query Language زیر را به روش 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 امتحان کنید. بعد از اینکه روی Run کلیک کردید، مکان‌دار شناسه فروشنده را به شناسه فروشنده خود در URL درخواست به‌روزرسانی کنید. می توانید پرس و جو را اصلاح کنید. جستجوی کامل باید در یک خط باقی بماند تا با کاوشگر API کار کند.

توجه: این راهنما درخواست اصلی HTTP را به عنوان یک ابزار آموزشی نشان می‌دهد، اما توصیه می‌کنیم از یکی از کتابخانه‌های مشتری برای ارسال درخواست‌های خود استفاده کنید.

URL درخواست HTTP

این درخواست شامل یک HTTP POST به Content API برای سرور خرید در آدرس اینترنتی زیر است:

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'"
}