Ví dụ bắt đầu nhanh

Dưới đây là một truy vấn mẫu cho ProductPerformanceView trả về hiệu suất tài khoản của bạn trong 30 ngày qua, được phân đoạn theo marketingMethod và offerId. Bạn có thể thử ví dụ nhanh này để biết quen thuộc với Merchant Reporting API.

Bạn cần có báo cáo Hiệu suất và thông tin chi tiết vai trò để truy xuất báo cáo này. Xem yêu cầu đối với chi tiết hơn.

Để tạo yêu cầu, hãy chuyển Truy vấn Merchant Center sau đây Ngôn ngữ cho thuộc tính accounts.reports.search phương thức:

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

URL yêu cầu HTTP

Yêu cầu này bao gồm một yêu cầu POST qua HTTP tới máy chủ API Báo cáo của người bán tại URL sau:

https://merchantapi.googleapis.com/reports/v1beta/accounts/parent/reports:search

Mẫu yêu cầu HTTP hoàn chỉnh

Dưới đây là một ví dụ hoàn chỉnh cho thấy định nghĩa báo cáo có trong yêu cầu POST qua HTTP:

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

Dưới đây là phản hồi mẫu:

{
  "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"
      }
    }
  ]
}