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
次の記号を使用できます。
?は省略可能な要素を示します。*は 0 以上を意味します。+は 1 つ以上を意味します。(xxxxxx)はグループを示します。[a-z0-9]は文字範囲を示します。|は「または」を表します。
大文字と小文字の区別
ほとんどの MCQL 演算子では大文字と小文字が区別されます。
| 演算子 | 大文字と小文字の区別 |
|---|---|
| = または != | 大文字と小文字を区別 |
| （NOT）IN | 大文字と小文字を区別 |
| （NOT）LIKE | 大文字と小文字を区別 |
| 次を含む（...） | 大文字と小文字を区別 |
| REGEXP_MATCH | （省略可）両方 |
句
MCQL でクエリできる句は次のとおりです。
SELECT
SELECT 句は、取得するフィールドのカンマ区切りのリストを受け取ります。
使用しているビューから任意のフィールドを選択できます。では、生成 AI の 次のフィールドを選択できます。
1 つのリクエストで複数のフィールド タイプをクエリできます。次の例をご覧ください。
SELECT
date,
marketingMethod,
impressions,
clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
FROM
FROM 句には、リクエストでデータを取得するテーブルを指定します。Google Chat では
FROM 句にフィールドを 1 つだけ指定する。FROM 句は、
すべてのクエリに適用されます。
WHERE
WHERE 句を使用して、リクエストのデータをフィルタリングします。WHERE 句
はパフォーマンスに必須です。
クエリをご覧ください。
すべてでフィルタできます
segments フィールド
さらに、
次の場合、metrics フィールド
SELECT 句で指定します。
WHERE を使用して、指定したセグメントのインプレッションのみを返す例を次に示します。
期間（8 月）:
SELECT offerId, impressions
FROM ProductPerformanceView
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
AND 演算子を使用すると、1 つのクエリで複数の条件でフィルタできます。
完全な条件間では AND を使用します（例: WHERE marketingMethod !=
"ADS" AND marketingMethod != "ORGANIC"）。内の値の間で AND を使用することはできません。
単一の条件（例: WHERE marketingMethod != "ADS" AND "ORGANIC"）。
商品ごとのクリック数を返す例を次に示します。
マーケティング メソッド「ADS」で、次の月に 100 回を超えるクリック
8 月：
SELECT offerId, clicks
FROM ProductPerformanceView
WHERE clicks > 100
AND marketingMethod = 'ADS'
AND date BETWEEN '2020-08-01' AND '2020-08-31'
WHERE 句は OR をサポートしていません。演算子では大文字と小文字が区別されます。1 つの
演算子の完全なリストについては、文法をご覧ください。
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'
日付文字列は一重引用符（'）または二重引用符で定義できます。
（"）。
相対
LAST_30_DAYS や THIS_MONTH などの相対的な期間を指定できます。
BETWEEN と AND の代わりに DURING を使用すると、次のようになります。
WHERE date DURING LAST_30_DAYS
使用可能な相対的な期間の一覧については、文法をご覧ください。