ตัวอย่าง

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

คุณต้องมีบทบาทผู้จัดการการรายงานเพื่อเรียกข้อมูลรายงานนี้

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

หมายเหตุ: คู่มือนี้จะแสดงคำขอ 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'"
}