範例

以下對 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'

執行

按一下「Run」，試用 API Explorer 中的範例。按一下「Run」後，請將要求網址中的商家 ID 預留位置更新為您自己的商家 ID。您可以修改查詢。完整查詢必須留在一行中，才能與 API Explorer 搭配使用。

注意： 本指南說明基礎 HTTP 要求是教學工具，但建議您使用其中一個用戶端程式庫提交要求。

HTTP 要求網址

這項要求會將 HTTP POST 傳送至位於下列網址的 Content API for Shopping 伺服器：

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