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

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

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

برای درخواست، عبارت 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"
      }
    }
  ]
}