此页面由 Cloud Translation API 翻译。

Merchant Center Query Language

Merchant Center 查询语言 (MCQL) 是一种查询语言，类似于 SQL。您可以将 MCQL 与 Merchant Reports API 来检索效果数据，了解您的商品以及所参与竞争的市场。

语法

下面是 MCQL 语法参考（采用正则表达式表示法）：

Query            -> SelectClause FromClause? WhereClause? OrderByClause? LimitClause?
SelectClause     -> SELECT FieldName (, FieldName)*
FromClause       -> FROM TableName
WhereClause      -> WHERE Condition (AND Condition)*
OrderByClause    -> ORDER BY Ordering (, Ordering)*
LimitClause      -> LIMIT PositiveInteger

Condition        -> FieldName Operator Value | FieldName BETWEEN Value AND Value
Operator         -> = | != | > | >= | < | <= | <> | IN | NOT IN |
                    CONTAINS ANY | CONTAINS ALL | CONTAINS NONE | DURING |
                    LIKE | NOT LIKE | REGEXP_MATCH | NOT REGEXP_MATCH
Value            -> Number | NumberList | String | StringList | Function
Ordering         -> FieldName (ASC | DESC)?

FieldName        -> [a-z] ([a-zA-Z0-9._])*
TableName        -> [A-Z] ([a-zA-Z_])*

StringList       -> ( String (, String)* )
NumberList       -> ( Number (, Number)* )

PositiveInteger  -> [1-9] ([0-9])*
Number           -> -? [0-9]+ (. [0-9] [0-9]*)?
String           -> (' Char* ') | (" Char* ")
Function         -> LAST_14_DAYS | LAST_30_DAYS | LAST_7_DAYS |
                    LAST_BUSINESS_WEEK | LAST_MONTH | LAST_WEEK_MON_SUN |
                    LAST_WEEK_SUN_SAT | THIS_MONTH | THIS_WEEK_MON_TODAY |
                    THIS_WEEK_SUN_TODAY | TODAY | YESTERDAY

您可以使用以下符号：

? 表示可选元素。
* 表示零个或更多个；+ 表示一个或多个。
(xxxxxx) 表示分组。
[a-z0-9] 表示字符范围。
| 代表“或”。

大小写区分

大多数 MCQL 运算符都区分大小写：

运算符	区分大小写
= 或 !=	区分大小写
(NOT) IN	区分大小写
(NOT) 顶	区分大小写
包含 (...)	区分大小写
REGEXP_MATCH	（可选）两者

条款

以下是您可以使用 MCQL 查询的子句：

SELECT

SELECT 子句接受以英文逗号分隔的字段列表来检索。

您可以从正在使用的视图中选择任何字段。以下是您可以选择的一些字段示例：

指标
- impressions
- clicks
细分
- date
- marketingMethod

您可以在单个请求中查询多个字段类型。示例如下：

SELECT
  date,
  marketingMethod,
  impressions,
  clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'

FROM

FROM 子句在请求中指定要从中提取数据的表。您只能在 FROM 子句中指定一个字段。所有查询都需要 FROM 子句。

WHERE

使用 WHERE 子句过滤请求的数据。性能查询需要使用 WHERE 子句。您可以按所有细分字段进行过滤，也可以在 SELECT 子句中指定其他metrics字段进行过滤。

以下示例使用 WHERE 仅返回指定时间段（8 月份）的展示次数：

SELECT offerId, impressions
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'

您可以使用 AND 运算符在单个查询中按多个条件进行过滤。在不同条件之间使用 AND，例如：WHERE marketingMethod != "ADS" AND marketingMethod != "ORGANIC"。您不能在单个条件中的值之间使用 AND，例如：WHERE marketingMethod != "ADS" AND "ORGANIC"。

以下示例返回 8 月份 ADS 营销方法对应的每个优惠的点击次数（点击次数超过 100）：

SELECT offerId, clicks
FROM ProductPerformanceView
WHERE clicks > 100
  AND marketingMethod = 'ADS'
  AND date BETWEEN '2020-08-01' AND '2020-08-31'

WHERE 子句不支持 OR。运算符区分大小写。如需查看运算符的完整列表，请参阅语法。

ORDER BY（可选）

ORDER BY 子句可让您按指定顺序检索结果。

按 fieldName 指定顺序，然后按 ASC 或 DESC 指定。您只能按查询的 SELECT 子句中指定的字段进行排序。如果您未指定，ORDER BY 默认为 ASC。

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

SELECT offerId, clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
ORDER BY clicks DESC

您可以使用逗号分隔列表在 ORDER BY 子句中指定多个字段。

例如，以下查询的结果按 offerId 升序排序，再按展示次数降序排序，再按点击次数降序排序：

SELECT offerId, impressions, clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
ORDER BY
  offerId,
  impressions DESC,
  clicks DESC

LIMIT

LIMIT 子句用于指定要返回的结果数量。

以下是一个仅返回 50 个结果的示例，即使有更多行可用。

SELECT offerId, impressions
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
ORDER BY impressions DESC
LIMIT 50

使用 pageSize 字段处理较长的结果列表。

日期范围

您可以利用 MCQL 指定自定义日期范围或相对日期范围。您必须使用 WHERE 子句为所有性能查询指定 date 范围。

自定义

您可按以下格式指定 ISO 8601(YYYY-MM-DD) 日期：

date BETWEEN '2021-01-01' AND '2021-01-31'
date >= '2021-01-01' AND date <= '2021-01-31'

您可以使用单引号 (') 或双引号 (") 定义日期字符串。