مثال شروع سریع

در اینجا یک جستجوی نمونه برای ProductPerformanceView وجود دارد که عملکرد حساب شما را در 30 روز گذشته برمی‌گرداند که بر اساس marketingMethod و offerId تقسیم‌بندی شده است. برای آشنایی با Merchant Reports API می توانید این مثال سریع را امتحان کنید.

برای بازیابی این گزارش به نقش عملکرد و بینش نیاز دارید. برای جزئیات بیشتر به الزامات مراجعه کنید.

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

برای ارسال درخواست، عبارت Merchant Center Query Language زیر را به روش accounts.reports.search ارسال کنید:

SELECT
  marketingMethod,
  offerId,
  impressions,
  clicks,
  clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2020-11-01' AND '2020-11-30'

URL درخواست HTTP

این درخواست شامل یک HTTP POST به سرور API گزارش‌های تجاری در 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"
      }
    }
  ]
}