Merchant Center Query Language (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) LIKE | केस-सेंसिटिव |
| CONTAINS (...) | केस-सेंसिटिव |
| REGEXP_MATCH | ज़रूरी नहीं कि दोनों केस-सेंसिटिव हों |
क्लॉज़
MCQL के साथ इन क्लॉज़ के लिए क्वेरी की जा सकती है:
SELECT
SELECT क्लॉज़ में, कॉमा से अलग की गई फ़ील्ड की सूची शामिल होती है. इससे उन फ़ील्ड का डेटा हासिल किया जा सकता है.
जिस व्यू का इस्तेमाल किया जा रहा है उसमें मौजूद किसी भी फ़ील्ड को चुना जा सकता है. यहां कुछ फ़ील्ड के उदाहरण दिए गए हैं जिन्हें चुना जा सकता है:
एक ही अनुरोध में, कई तरह के फ़ील्ड के लिए क्वेरी की जा सकती है. यहां एक उदाहरण दिया गया है:
SELECT
date,
marketing_method,
impressions,
clicks
FROM product_performance_view
WHERE date BETWEEN '2023-08-01' AND '2023-08-31'
FROM
FROM क्लॉज़ में, वह टेबल तय की जाती है जिससे अनुरोध में डेटा फ़ेच किया जाना है. FROM क्लॉज़ में सिर्फ़ एक फ़ील्ड तय किया जा सकता है. सभी क्वेरी के लिए, FROM क्लॉज़ ज़रूरी है.
WHERE
अनुरोध के लिए डेटा को फ़िल्टर करने के लिए, WHERE क्लॉज़ का इस्तेमाल करें. परफ़ॉर्मेंस से जुड़ी क्वेरी के लिए, WHERE क्लॉज़
ज़रूरी है.
सभी
सेगमेंट फ़ील्ड के हिसाब से फ़िल्टर किया जा सकता है.
साथ ही, अगर
मेट्रिक के अतिरिक्त फ़ील्ड तय किए गए हैं, तो उनके हिसाब से भी फ़िल्टर किया जा सकता है SELECT क्लॉज़ में.
यहां एक उदाहरण दिया गया है, जिसमें WHERE का इस्तेमाल करके, सिर्फ़ तय की गई समयावधि (अगस्त का महीना) के इंप्रेशन दिखाए गए हैं:
SELECT offer_id, impressions
FROM product_performance_view
WHERE date BETWEEN '2023-08-01' AND '2023-08-31'
AND ऑपरेटर की मदद से, एक ही क्वेरी में कई शर्तों के हिसाब से फ़िल्टर किया जा सकता है.
पूरी शर्तों के बीच AND का इस्तेमाल करें. उदाहरण के लिए: WHERE marketing_method !=
"ADS" AND marketing_method != "ORGANIC". एक ही शर्त में वैल्यू के बीच AND का इस्तेमाल नहीं किया जा सकता. उदाहरण के लिए: WHERE marketing_method != "ADS" AND
"ORGANIC".
यहां एक उदाहरण दिया गया है, जिसमें हर ऑफ़र के लिए क्लिक की संख्या दिखाई गई है. इसमें, ADS मार्केटिंग के तरीके के लिए, अगस्त महीने में 100 से ज़्यादा क्लिक हुए हैं:
SELECT offer_id, clicks
FROM product_performance_view
WHERE clicks > 100
AND marketing_method = 'ADS'
AND date BETWEEN '2023-08-01' AND '2023-08-31'
WHERE क्लॉज़, OR के साथ काम नहीं करता. ऑपरेटर केस-सेंसिटिव होते हैं. ऑपरेटर की पूरी सूची देखने के लिए, व्याकरण देखें.
ORDER BY (ज़रूरी नहीं)
ORDER BY क्लॉज़ की मदद से, तय किए गए क्रम में नतीजे हासिल किए जा सकते हैं.
क्रम तय करने के लिए, सबसे पहले field_name तय करें. इसके बाद, ASC या DESC तय करें. क्वेरी के SELECT क्लॉज़ में तय किए गए फ़ील्ड के हिसाब से ही क्रम तय किया जा सकता है. अगर ORDER BY तय नहीं किया जाता है, तो डिफ़ॉल्ट रूप से ASC क्रम लागू होता है.
यहां दी गई क्वेरी में, लौटाए गए कॉलम को क्लिक की संख्या के हिसाब से क्रम में लगाया गया है. इसमें सबसे ज़्यादा क्लिक वाले कॉलम को सबसे पहले दिखाया गया है:
SELECT offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-08-01' AND '2023-08-31'
ORDER BY clicks DESC
कॉमा से अलग की गई सूची का इस्तेमाल करके, ORDER BY क्लॉज़ में कई फ़ील्ड तय किए जा सकते हैं.
उदाहरण के लिए, यहां दी गई क्वेरी के नतीजों को बढ़ते क्रम में offer_id के हिसाब से क्रमबद्ध किया गया है. इसके बाद, इंप्रेशन की संख्या के हिसाब से घटते क्रम में और फिर क्लिक की संख्या के हिसाब से घटते क्रम में क्रमबद्ध किया गया है:
SELECT offer_id, impressions, clicks
FROM product_performance_view
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
ORDER BY
offer_id,
impressions DESC,
clicks DESC
LIMIT
LIMIT क्लॉज़ की मदद से, लौटाए जाने वाले नतीजों की संख्या तय की जा सकती है.
यहां एक उदाहरण दिया गया है, जिसमें सिर्फ़ 50 नतीजे लौटाए गए हैं. भले ही, ज़्यादा कॉलम उपलब्ध हों.
SELECT offer_id, impressions
FROM product_performance_view
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
ORDER BY impressions DESC
LIMIT 50
नतीजों की लंबी सूचियों को मैनेज करने के लिए, pageSize फ़ील्ड का इस्तेमाल करें.
समय अवधियां
MCQL की मदद से, पसंद के मुताबिक या मिलती-जुलती तारीख की सीमा तय की जा सकती है. परफ़ॉर्मेंस से जुड़ी सभी queries के लिए,
WHERE क्लॉज़ का इस्तेमाल करके date की सीमा तय करना ज़रूरी है.
पसंद के मुताबिक
आईएसओ 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
मिलती-जुलती तारीख की सीमाओं की पूरी सूची देखने के लिए, व्याकरण देखें.