此页面由 Cloud Translation API 翻译。

查询结构

您可以将对指标和细分字段的查询发送到 reports.search 方法。要使用 Merchant Center 查询语言构建查询，您需要先编写使用语言语法进行查询。一个查询由多个子句组成：

SELECT
FROM
WHERE
ORDER BY
LIMIT

子句使用字段名称、表名、运算符、条件和条件。排序，帮助您选择所需的数据。一旦合并为则可以使用 Google Content API for Shopping 提出请求。下面我们来看一下子句。

条款

选择

SELECT 子句指定要在请求中提取的一组字段。SELECT 采用逗号分隔的细分字段和指标列表，返回值。SELECT 子句在查询中是必需子句。

下面是一个从给定表中选择点击指标的示例查询：

SELECT
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

您还可以在单个请求中查询不同的字段类型：

SELECT
  segments.date,
  segments.program,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

细分字段
- segments.date
- segments.program
指标
- metrics.impressions
- metrics.clicks

SELECT 子句中不允许包含某些字段，原因如下：限制：

查询至少一个指标字段的细分字段。

有关上述情况的信息，请参阅我们的参考文档。

FROM

FROM 子句在请求中指定要从中提取数据的表。通过 FROM 子句中的表定义了所有其他子句。只能在 FROM 子句。目前仅支持 MerchantPerformanceView 表。在查询 search 方法时必须使用 FROM 子句 reports 服务。

WHERE

WHERE 子句指定在根据请求。使用 WHERE 子句时，可以指定一个或多个条件使用 AND 分隔它们。每个条件都应遵循 field_name Operator value。任何细分字段都可以在 WHERE 中使用子句中，但需要在 SELECT 子句中指定指标字段在 WHERE 子句中使用。WHERE 子句在查询中是必需子句，因为您必须始终指定效果数据。

以下示例演示了如何使用 WHERE 返回指定时间段的指标：

SELECT
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

您可以结合使用多个条件来过滤数据。这个示例将返回 SHOPPING_ADS 计划中每种优惠的点击次数，其中点击次数 > 在指定 30 天的期限内达到 100 人。

SELECT
  segments.offer_id,
  segments.program,
  metrics.clicks
FROM MerchantPerformanceView
WHERE metrics.clicks > 100
  AND segments.program = SHOPPING_ADS
  AND segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’;

在以下查询中，您会发现选择了 segments.date。无论您是否选择segments.date，始终必须提供 WHERE 子句来检索性能数据。

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

在过滤时，请务必根据运算符区分大小写。

有关运算符的完整列表，请参阅语言语法。

ORDER BY

ORDER BY 子句指定结果的显示顺序返回。这样一来，您就可以根据字段名称按升序或降序排列相关数据。每项排序都指定为 field_name，后跟 ASC 或 DESC。如果 ASC 和 DESC 均未指定，则默认顺序发送至 ASC。只有 SELECT 子句中指定的字段才能用在 ORDER BY 子句。ORDER BY 子句在查询中是可选子句。

以下查询按点击次数从高到低对返回的行进行排序最低：

SELECT
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY metrics.clicks DESC

您可以使用英文逗号分隔的 ORDER BY 子句中指定多个字段列表。系统将按照查询中指定的顺序进行排序。例如，在此查询中，结果将按 offer_id，然后按展示次数降序排列，然后进入按点击次数降序排列：

SELECT
  segments.offer_id,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY
  segments.offer_id,
  metrics.impressions DESC,
  metrics.clicks DESC

LIMIT

LIMIT 子句用于指定要返回的结果数。如果您只对摘要感兴趣，这会非常有用。

例如，LIMIT 可用于限制以下查询的结果总数：

SELECT
  segments.program,
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY metrics.impressions DESC
LIMIT 50