Ví dụ

Dưới đây là một truy vấn mẫu cho MerchantPerformanceView trả về hiệu suất của tài khoản trong 30 ngày qua, được phân đoạn theo programoffer_id. Bạn có thể thử ví dụ nhanh này để làm quen với dịch vụ Reports.

Bạn cần có vai trò Người quản lý báo cáo để truy xuất báo cáo này.

Để đưa ra yêu cầu, hãy chuyển câu lệnh Ngôn ngữ truy vấn sau đây trong Merchant Center đến phương thức 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'

Chạy

Nhấp vào Run (Chạy) để dùng thử mẫu trong API Explorer. Sau khi bạn nhấp vào Chạy, hãy cập nhật phần giữ chỗ mã người bán thành mã người bán của chính bạn trong URL yêu cầu. Bạn có thể sửa đổi truy vấn. Truy vấn đầy đủ phải nằm trên một dòng để có thể làm việc với trình khám phá API.

URL yêu cầu HTTP

Yêu cầu bao gồm một yêu cầu POST qua HTTP tới máy chủ Content API for Shopping tại URL sau:

https://shoppingcontent.googleapis.com/content/v2.1/merchantId/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 ở trên, được đính kèm trong yêu cầu POST HTTP:

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