ตัวอย่าง

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

คุณต้องมีบทบาทผู้จัดการการรายงาน จึงจะดึงข้อมูลรายงานนี้ได้

หากต้องการส่งคำขอ ให้ส่งคำสั่ง Merchant Center Query Language ต่อไปนี้ไปยัง 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 หลังจากคลิก เรียกใช้ ให้อัปเดตรหัสผู้ขายที่เป็นตัวยึดตำแหน่งเป็นรหัสผู้ขายของคุณเองใน URL ของคำขอ คุณสามารถแก้ไขคําค้นหาได้ คําค้นหาแบบเต็มต้องอยู่ในบรรทัดเดียวจึงจะใช้กับ API Explorer ได้

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

URL ของคำขอ 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'"
}