مثال

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

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

برای ایجاد درخواست، عبارت زیر را به متد 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'

اجرا کنید

برای امتحان کردن نمونه در API Explorer ، روی Run کلیک کنید. پس از کلیک روی Run ، شناسه فروشنده را در URL درخواست به شناسه فروشنده خودتان تغییر دهید. می‌توانید پرس‌وجو را تغییر دهید. برای کار با API explorer، کل پرس‌وجو باید در یک خط باقی بماند.

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

آدرس درخواست 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'"
}