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 program và offer_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.

Để tạo yêu cầu, hãy chuyển câu lệnh Ngôn ngữ truy vấn Merchant Center sau đây sang 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 (Trình khám phá API). Sau khi bạn nhấp vào Run (Chạy), hãy cập nhật phần giữ chỗ cho 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 cụm từ tìm kiếm. Truy vấn đầy đủ phải nằm trên một dòng thì mới có thể hoạt động với trình khám phá API.

Lưu ý: Hướng dẫn này trình bày yêu cầu HTTP cơ bản dưới dạng một công cụ giảng dạy, nhưng bạn nên sử dụng một trong các thư viện ứng dụng để gửi yêu cầu.

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à ví dụ đầy đủ cho thấy định nghĩa báo cáo ở trên kèm theo 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'"
}