示例

下面是一个对 MerchantPerformanceView 的查询示例,该查询会返回您的帐号在过去 30 天内的效果,并按 programoffer_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 Explorer 中试用示例。点击运行后,在请求网址中将商家 ID 占位符更新为您自己的商家 ID。您可以修改查询。完整查询必须保留一行,才能使用 API Explorer

HTTP 请求网址

此请求包含要提交到 Content API for Shopping 服务器的 HTTP POST,服务器网址如下:

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