ตัวอย่างการเริ่มต้นอย่างรวดเร็ว

ต่อไปนี้คือตัวอย่างการค้นหาที่ส่งไปยัง product_performance_view ซึ่งแสดงประสิทธิภาพของบัญชีในช่วง 30 วันที่ผ่านมา โดยแบ่งตาม marketing_method และ offer_id คุณลองดูตัวอย่างสั้นๆ นี้เพื่อทำความคุ้นเคยกับ Merchant Reports API ได้

คุณต้องมีบทบาทด้านประสิทธิภาพและข้อมูลเชิงลึกจึงจะเรียกดูรายงานนี้ได้ ดูรายละเอียดเพิ่มเติมได้ในข้อกำหนด

หมายเหตุ: คู่มือนี้แสดงคําขอ HTTP พื้นฐานเป็นเครื่องมือการสอน แต่เราขอแนะนําให้ใช้คลังไคลเอ็นต์อย่างใดอย่างหนึ่งเพื่อส่งคําขอ

หากต้องการส่งคำขอ ให้ส่งคำสั่ง Merchant Center Query Language ต่อไปนี้ไปยังเมธอด accounts.reports.search

SELECT
  marketing_method,
  offer_id,
  impressions,
  clicks,
  click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'

URL คำขอ HTTP

คําขอประกอบด้วย HTTP POST ไปยังเซิร์ฟเวอร์ Merchant Reports 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
              marketing_method,
              offer_id,
              impressions,
              clicks,
              click_through_rate
            FROM product_performance_view
            WHERE date BETWEEN '2023-11-01' AND '2023-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"
      }
    }
  ]
}