इंडेक्स
PromotionsService
(इंटरफ़ेस)Attributes
(मैसेज)CouponValueType
(enum)GetPromotionRequest
(मैसेज)InsertPromotionRequest
(मैसेज)ListPromotionsRequest
(मैसेज)ListPromotionsResponse
(मैसेज)OfferType
(enum)ProductApplicability
(enum)Promotion
(मैसेज)PromotionStatus
(मैसेज)PromotionStatus.DestinationStatus
(मैसेज)PromotionStatus.DestinationStatus.State
(enum)PromotionStatus.ItemLevelIssue
(मैसेज)PromotionStatus.ItemLevelIssue.Severity
(enum)RedemptionChannel
(enum)StoreApplicability
(enum)
PromotionsService
प्रॉडक्ट के प्रमोशन मैनेज करने की सेवा.
GetPromotion |
---|
यह आपके Merchant Center खाते से प्रमोशन की जानकारी हासिल करता है. प्रमोशन का इनपुट डालने या अपडेट करने के बाद, अपडेट किए गए प्रमोशन को वापस पाने में कुछ मिनट लग सकते हैं.
|
InsertPromotion |
---|
आपके Merchant Center खाते के लिए प्रमोशन शामिल करता है. अगर प्रमोशन पहले से मौजूद है, तो यह प्रमोशन को अपडेट कर देता है.
|
ListPromotions |
---|
आपके Merchant Center खाते में मौजूद प्रमोशन की सूची दिखाता है. जवाब में प्रमोशन डालने या अपडेट करने के बाद, प्रोसेस किए गए अपडेट किए गए प्रमोशन को वापस पाने में कुछ मिनट लग सकते हैं.
|
विशेषताएं
एट्रिब्यूट.
फ़ील्ड | |
---|---|
product_ |
ज़रूरी है. प्रमोशन सभी प्रॉडक्ट पर लागू होगा या सिर्फ़ कुछ खास प्रॉडक्ट पर. |
offer_ |
ज़रूरी है. प्रमोशन का टाइप. इस एट्रिब्यूट का इस्तेमाल करके बताएं कि प्रमोशन को रिडीम करने के लिए, खरीदारों को कूपन कोड की ज़रूरत है या नहीं. |
generic_ |
ज़रूरी नहीं. प्रमोशन के लिए जेनरिक रिडेंप्शन कोड. इसका इस्तेमाल |
long_ |
ज़रूरी है. प्रमोशन के लिए लंबा टाइटल. |
coupon_ |
ज़रूरी है. कूपन वैल्यू टाइप एट्रिब्यूट से पता चलता है कि किस तरह का प्रमोशन किया जा रहा है. चुने गए कूपन की वैल्यू के टाइप के हिसाब से, कुछ एट्रिब्यूट की वैल्यू देना ज़रूरी है. |
promotion_ |
ज़रूरी है. उन डेस्टिनेशन की सूची जहां प्रमोशन लागू होता है. अगर डेटा सोर्स में इस्तेमाल की जा सकने वाली वैल्यू को शामिल करके, किसी डेस्टिनेशन की जानकारी नहीं दी जाती है, तो आपका प्रमोशन डिफ़ॉल्ट रूप से, शॉपिंग विज्ञापनों और मुफ़्त में दिखाई जाने वाली लिस्टिंग में दिखेगा. ऐसा हो सकता है कि आपने इससे पहले, अपने प्रॉडक्ट के डेस्टिनेशन के तौर पर ये वैल्यू सबमिट की हों: Shopping Actions, Surfaces across Google, Local surfaces across Google. इन वैल्यू को दिखाने के लिए, |
item_ |
ज़रूरी नहीं. प्रमोशन के लिए, आइटम आईडी के हिसाब से प्रॉडक्ट फ़िल्टर. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन में शामिल होने की ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट |
brand_ |
ज़रूरी नहीं. प्रमोशन के लिए, ब्रैंड के हिसाब से प्रॉडक्ट फ़िल्टर. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन में शामिल होने की ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट |
item_ |
ज़रूरी नहीं. प्रमोशन के लिए, सामान के ग्रुप के आईडी के हिसाब से प्रॉडक्ट फ़िल्टर. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन में शामिल होने की ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट [product_applicability] एट्रिब्यूट की वैल्यू, specific_products के तौर पर सेट होती है. |
product_ |
ज़रूरी नहीं. प्रमोशन के लिए, प्रॉडक्ट टाइप के हिसाब से प्रॉडक्ट फ़िल्टर. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन के लिए ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट के लिए |
item_ |
ज़रूरी नहीं. प्रमोशन के लिए, आइटम आईडी एक्सक्लूज़न के हिसाब से प्रॉडक्ट फ़िल्टर करें. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन में शामिल होने की ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट |
brand_ |
ज़रूरी नहीं. प्रमोशन के लिए, शामिल नहीं किए गए ब्रैंड के हिसाब से प्रॉडक्ट फ़िल्टर. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन में शामिल होने की ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट |
item_ |
ज़रूरी नहीं. सामान के ग्रुप का आईडी के हिसाब से प्रॉडक्ट फ़िल्टर करें. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन में शामिल होने की ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट के लिए |
product_ |
ज़रूरी नहीं. प्रमोशन के लिए, प्रॉडक्ट टाइप एक्सक्लूज़न के हिसाब से प्रॉडक्ट फ़िल्टर. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन में शामिल होने की ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट |
minimum_ |
ज़रूरी नहीं. प्रमोशन को रिडीम करने के लिए, खरीदारी की कम से कम कीमत. |
minimum_ |
ज़रूरी नहीं. प्रमोशन के लिए, खरीदारी के लिए ज़रूरी कम से कम संख्या. |
limit_ |
ज़रूरी नहीं. प्रमोशन के लिए, प्रॉडक्ट की खरीदी जा सकने वाली ज़्यादा से ज़्यादा संख्या. |
limit_ |
ज़रूरी नहीं. प्रमोशन के लिए, प्रॉडक्ट की ज़्यादा से ज़्यादा कीमत. |
percent_ |
ज़रूरी नहीं. प्रमोशन में ऑफ़र की गई छूट का प्रतिशत. |
money_ |
ज़रूरी नहीं. प्रमोशन में दी गई छूट की रकम. |
get_ |
ज़रूरी नहीं. प्रमोशन में छूट वाले आइटम की संख्या. एट्रिब्यूट तब सेट होता है, जब |
free_ |
ज़रूरी नहीं. प्रमोशन के लिए, मुफ़्त उपहार की वैल्यू. |
free_ |
ज़रूरी नहीं. प्रमोशन के लिए, मुफ़्त उपहार का ब्यौरा. |
free_ |
ज़रूरी नहीं. प्रमोशन के लिए मुफ़्त उपहार का आइटम आईडी. |
promotion_ |
ज़रूरी है. |
promotion_ |
ज़रूरी नहीं. |
store_ |
ज़रूरी नहीं. प्रमोशन सभी स्टोर पर लागू होगा या सिर्फ़ कुछ खास स्टोर पर. अगर स्टोर में प्रमोशन करने के लिए किसी स्टोर को लागू नहीं किया जाता है, तो स्थानीय इन्वेंट्री विज्ञापनों के प्रमोशन में गड़बड़ी होती है. अगर |
store_ |
ज़रूरी नहीं. प्रमोशन के लिए शामिल किए जाने वाले स्टोर कोड. स्टोर फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब उस स्टोर का स्टोर कोड (Business Profile में मौजूद स्टोर आईडी) जहां प्रॉडक्ट बेचा जाता है. ज़्यादा जानकारी के लिए, स्थानीय प्रॉडक्ट इन्वेंट्री डेटा स्पेसिफ़िकेशन देखें. |
store_ |
ज़रूरी नहीं. प्रमोशन के लिए, किन स्टोर कोड को शामिल नहीं करना है. स्टोर फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब |
promotion_ |
ज़रूरी नहीं. कारोबारी या कंपनी की साइट पर मौजूद उस पेज का यूआरएल जहां प्रमोशन दिखता है. अगर |
CouponValueType
किसी प्रमोशन के लिए, कूपन की वैल्यू किस तरह की है.
Enums | |
---|---|
COUPON_VALUE_TYPE_UNSPECIFIED |
इससे पता चलता है कि कूपन की वैल्यू किस तरह की है, इसकी जानकारी नहीं दी गई है. |
MONEY_OFF |
कूपन की वैल्यू टाइप पर छूट. |
PERCENT_OFF |
कूपन की वैल्यू टाइप पर प्रतिशत की छूट. |
BUY_M_GET_N_MONEY_OFF |
M खरीदें, N रुपये की छूट पाएं. कूपन की वैल्यू किस तरह की है. minimum_purchase_quantity और get_this_quantity_discounted मौजूद होने चाहिए. money_off_amount भी मौजूद होना चाहिए. |
BUY_M_GET_N_PERCENT_OFF |
M संख्या में प्रॉडक्ट खरीदें, कूपन की वैल्यू किस तरह की है पर N प्रतिशत की छूट पाएं. minimum_purchase_quantity और get_this_quantity_discounted मौजूद होने चाहिए. percent_off_percentage भी मौजूद होना चाहिए. |
BUY_M_GET_MONEY_OFF |
M संख्या में प्रॉडक्ट खरीदें, इतने रुपये की छूट पाएं. minimum_purchase_quantity और money_off_amount मौजूद होने चाहिए. |
BUY_M_GET_PERCENT_OFF |
M खरीदें, इतने रुपये की छूट पाएं. minimum_purchase_quantity और percent_off_percentage मौजूद होने चाहिए. |
FREE_GIFT |
मुफ़्त उपहार का सिर्फ़ ब्यौरा. |
FREE_GIFT_WITH_VALUE |
मुफ़्त उपहार की कीमत. |
FREE_GIFT_WITH_ITEM_ID |
आइटम आईडी के साथ मुफ़्त उपहार. |
FREE_SHIPPING_STANDARD |
मुफ़्त स्टैंडर्ड शिपिंग वाले कूपन की वैल्यू का टाइप. |
FREE_SHIPPING_OVERNIGHT |
एक दिन में डिलीवरी वाली मुफ़्त शिपिंग के कूपन की वैल्यू का टाइप. |
FREE_SHIPPING_TWO_DAY |
दो दिन में डिलीवरी वाली मुफ़्त शिपिंग के कूपन की वैल्यू किस तरह की है. |
GetPromotionRequest
GetPromotion
तरीके के लिए अनुरोध मैसेज.
फ़ील्ड | |
---|---|
name |
ज़रूरी है. जिस प्रमोशन को वापस लाना है उसका नाम. फ़ॉर्मैट: |
InsertPromotionRequest
InsertPromotion
तरीके के लिए अनुरोध मैसेज.
फ़ील्ड | |
---|---|
parent |
ज़रूरी है. वह खाता जिसमें प्रमोशन डाला जाएगा. फ़ॉर्मैट: accounts/{account} |
promotion |
ज़रूरी है. जो प्रमोशन डालना है. |
data_ |
ज़रूरी है. प्रमोशन फ़ॉर्मैट का डेटा सोर्स: |
ListPromotionsRequest
ListPromotions
तरीके के लिए अनुरोध से जुड़ा मैसेज.
फ़ील्ड | |
---|---|
parent |
ज़रूरी है. वह खाता जिसके लिए प्रोसेस किए गए प्रमोशन की सूची बनानी है. फ़ॉर्मैट: |
page_ |
सिर्फ़ आउटपुट के लिए. ज़्यादा से ज़्यादा कितने प्रमोशन दिखाने हैं. सेवा इस वैल्यू से कम वैल्यू दिखा सकती है. ज़्यादा से ज़्यादा वैल्यू 250 हो सकती है. 250 से ज़्यादा वैल्यू को 250 मान लिया जाएगा. अगर कोई वैल्यू सबमिट नहीं की जाती है, तो ज़्यादा से ज़्यादा प्रमोशन दिखाए जाएंगे. |
page_ |
सिर्फ़ आउटपुट के लिए. पेज टोकन, जो पिछले पेज बनाते समय, |
ListPromotionsResponse
ListPromotions
तरीके के लिए रिस्पॉन्स मैसेज.
फ़ील्ड | |
---|---|
promotions[] |
बताए गए खाते से प्रोसेस किए गए प्रमोशन. |
next_ |
एक टोकन, जिसे अगले पेज को वापस पाने के लिए |
OfferType
प्रमोशन का ऑफ़र टाइप.
Enums | |
---|---|
OFFER_TYPE_UNSPECIFIED |
ऑफ़र का टाइप अज्ञात है. |
NO_CODE |
कोड के बिना मिलने वाला ऑफ़र. |
GENERIC_CODE |
कोड के साथ ऑफ़र का टाइप. जब offerType = GENERIC_CODE हो, तो प्रमोशन के लिए जेनरिक रिडेंप्शन कोड देना ज़रूरी है. |
ProductApplicability
प्रमोशन किस प्रॉडक्ट या प्रॉडक्ट की सूची पर लागू होता है.
Enums | |
---|---|
PRODUCT_APPLICABILITY_UNSPECIFIED |
यह पता नहीं है कि प्रमोशन किन प्रॉडक्ट पर लागू होता है. |
ALL_PRODUCTS |
यह सभी प्रॉडक्ट पर लागू होता है. |
SPECIFIC_PRODUCTS |
यह सिर्फ़ एक प्रॉडक्ट या प्रॉडक्ट की सूची पर लागू होता है. |
प्रमोशन
किसी प्रमोशन के बारे में जानकारी देता है. ज़्यादा जानकारी के लिए, नीचे दिए गए लेख पढ़ें.
डेटा की पुष्टि करने से जुड़ी जांचों को पास करने के लिए, प्रमोशन के इनपुट एट्रिब्यूट की ज़रूरत होती है. इनके बारे में यहां बताया गया है:
प्रमोशन इनपुट डालने और उसे अपडेट करने के बाद, फ़ाइनल प्रमोशन को वापस पाने में कुछ मिनट लग सकते हैं.
फ़ील्ड | |
---|---|
name |
आइडेंटिफ़ायर. प्रचार का नाम. फ़ॉर्मैट: |
promotion_ |
ज़रूरी है. प्रमोशन की खास पहचान करने के लिए, उपयोगकर्ता ने जो प्रमोशन आईडी दिया है. प्रमोशन को अस्वीकार होने से बचाने के लिए, ज़रूरी शर्तों का पालन करें. |
content_ |
ज़रूरी है. प्रमोशन के लिए, दो अक्षरों वाला ISO 639-1 भाषा कोड. प्रमोशन की सुविधा सिर्फ़ चुनिंदा भाषाओं के लिए उपलब्ध है. |
target_ |
ज़रूरी है. टारगेट किया गया देश, जिसका इस्तेमाल यूनीक आइडेंटिफ़ायर के तौर पर किया जाता है. इसे देश/इलाके के CLDR कोड के तौर पर दिखाया जाता है. प्रमोशन सिर्फ़ चुनिंदा देशों में उपलब्ध हैं, मुफ़्त में दिखाई जाने वाली लिस्टिंग और शॉपिंग विज्ञापन स्थानीय इन्वेंट्री विज्ञापन |
redemption_ |
ज़रूरी है. प्रमोशन के लिए रिडेम्पशन चैनल. कम से कम एक चैनल का होना ज़रूरी है. |
data_ |
सिर्फ़ आउटपुट के लिए. प्रमोशन का प्राइमरी डेटा सोर्स. |
attributes |
ज़रूरी नहीं. प्रमोशन एट्रिब्यूट की सूची. |
custom_ |
ज़रूरी नहीं. कस्टम (व्यापारी का दिया गया) एट्रिब्यूट की सूची. इसका इस्तेमाल, डेटा स्पेसिफ़िकेशन के किसी भी एट्रिब्यूट को उसके जेनरिक रूप में सबमिट करने के लिए भी किया जा सकता है. जैसे, |
promotion_ |
सिर्फ़ आउटपुट के लिए. प्रमोशन की स्थिति, डेटा की पुष्टि से जुड़ी समस्याएं, यानी प्रमोशन के बारे में ऐसी जानकारी जिसे एसिंक्रोनस तरीके से कंप्यूट किया गया है. |
version_ |
ज़रूरी नहीं. प्रमोशन के मौजूदा वर्शन (नयापन) को दिखाता है. इसका इस्तेमाल, एक ही समय पर कई अपडेट किए जाने पर सही क्रम को बनाए रखने के लिए किया जा सकता है. अगर यह सेट है, तो मौजूदा प्रमोशन के मौजूदा वर्शन नंबर से कम वर्शन नंबर होने पर, इंसर्शन को रोक दिया जाता है. मौजूदा अगर कार्रवाई को रोका जाता है, तो रद्द किया गया अपवाद लागू कर दिया जाएगा. |
PromotionStatus
प्रमोशन की स्थिति.
फ़ील्ड | |
---|---|
destination_ |
सिर्फ़ आउटपुट के लिए. प्रमोशन के लिए टारगेट किए गए डेस्टिनेशन. |
item_ |
सिर्फ़ आउटपुट के लिए. प्रमोशन से जुड़ी समस्याओं की सूची. |
creation_ |
सिर्फ़ आउटपुट के लिए. प्रमोशन बनाने की तारीख, ISO 8601 फ़ॉर्मैट में: तारीख, समय, और ऑफ़सेट. उदाहरण के लिए, |
last_ |
सिर्फ़ आउटपुट के लिए. ISO 8601 फ़ॉर्मैट में, प्रमोशन की स्थिति को पिछली बार अपडेट करने की तारीख: तारीख, समय, और ऑफ़सेट. उदाहरण के लिए, |
DestinationStatus
चुने गए डेस्टिनेशन का स्टेटस.
फ़ील्ड | |
---|---|
reporting_ |
सिर्फ़ आउटपुट के लिए. प्रमोशन डेस्टिनेशन का नाम. |
status |
सिर्फ़ आउटपुट के लिए. चुने गए डेस्टिनेशन का स्टेटस. |
स्थिति
प्रमोशन की मौजूदा स्थिति.
Enums | |
---|---|
STATE_UNSPECIFIED |
प्रमोशन की स्थिति की जानकारी नहीं है. |
IN_REVIEW |
प्रमोशन की समीक्षा की जा रही है. |
REJECTED |
प्रमोशन अस्वीकार कर दिया गया है. |
LIVE |
प्रमोशन को मंज़ूरी मिल गई है और वह चालू है. |
STOPPED |
मर्चेंट ने प्रमोशन को रोक दिया है. |
EXPIRED |
प्रमोशन अब चालू नहीं है. |
PENDING |
प्रमोशन बंद नहीं हुआ है और सभी समीक्षाओं को मंज़ूरी मिल गई है. हालांकि, प्रमोशन की तारीख आने वाली है. |
ItemLevelIssue
प्रमोशन से जुड़ी समस्या.
फ़ील्ड | |
---|---|
code |
सिर्फ़ आउटपुट के लिए. समस्या का गड़बड़ी कोड. |
severity |
सिर्फ़ आउटपुट के लिए. इस समस्या से प्रमोशन दिखाने पर क्या असर पड़ता है. |
resolution |
सिर्फ़ आउटपुट के लिए. क्या व्यापारी/कंपनी इस समस्या को हल कर सकती है. |
attribute |
सिर्फ़ आउटपुट के लिए. अगर समस्या किसी एक एट्रिब्यूट की वजह से है, तो एट्रिब्यूट का नाम. |
reporting_ |
सिर्फ़ आउटपुट के लिए. वह डेस्टिनेशन जिस पर समस्या लागू होती है. |
description |
सिर्फ़ आउटपुट के लिए. समस्या के बारे में अंग्रेज़ी में कम शब्दों में जानकारी. |
detail |
सिर्फ़ आउटपुट के लिए. समस्या के बारे में पूरी जानकारी, अंग्रेज़ी में. |
documentation |
सिर्फ़ आउटपुट के लिए. इस समस्या को हल करने में मदद करने के लिए, किसी वेब पेज का यूआरएल. |
applicable_ |
सिर्फ़ आउटपुट के लिए. उन देशों के कोड (ISO 3166-1 alpha-2) की सूची जहां ऑफ़र पर समस्या लागू होती है. |
गंभीरता
समस्या की गंभीरता.
Enums | |
---|---|
SEVERITY_UNSPECIFIED |
तय नहीं किया गया. |
NOT_IMPACTED |
यह गड़बड़ी एक चेतावनी है. इससे प्रमोशन पर सीधा असर नहीं पड़ता. |
DEMOTED |
प्रमोशन की रैंकिंग कम हो जाती है और खोज के नतीजों में उसकी परफ़ॉर्मेंस पर असर पड़ सकता है |
DISAPPROVED |
समस्या की वजह से प्रमोशन अस्वीकार हो गया. |
RedemptionChannel
प्रमोशन का चैनल.
Enums | |
---|---|
REDEMPTION_CHANNEL_UNSPECIFIED |
इससे पता चलता है कि चैनल के बारे में कोई जानकारी नहीं दी गई है. |
IN_STORE |
इससे पता चलता है कि चैनल स्टोर में मौजूद है. यह products के लिए इस्तेमाल किए गए local चैनल के बराबर है. |
ONLINE |
इससे पता चलता है कि चैनल ऑनलाइन है. |
StoreApplicability
स्टोर कोड या उन स्टोर कोड की सूची जिन पर प्रमोशन लागू होता है. सिर्फ़ स्थानीय इन्वेंट्री विज्ञापनों के प्रमोशन के लिए.
Enums | |
---|---|
STORE_APPLICABILITY_UNSPECIFIED |
यह पता नहीं है कि प्रमोशन किन स्टोर कोड पर लागू होता है. |
ALL_STORES |
प्रमोशन सभी स्टोर पर लागू होता है. |
SPECIFIC_STORES |
प्रमोशन सिर्फ़ बताए गए स्टोर पर लागू होता है. |