इंडेक्स
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 |
प्रमोशन सिर्फ़ बताए गए स्टोर पर लागू होता है. |