इंडेक्स
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_applicability |
ज़रूरी है. सभी प्रॉडक्ट या सिर्फ़ चुनिंदा प्रॉडक्ट पर प्रमोशन लागू होना. |
offer_type |
ज़रूरी है. प्रमोशन का टाइप. इस एट्रिब्यूट का इस्तेमाल करके बताएं कि प्रमोशन को रिडीम करने के लिए, खरीदारों को कूपन कोड की ज़रूरत है या नहीं. |
generic_redemption_code |
ज़रूरी नहीं. प्रमोशन के लिए जेनरिक रिडेंप्शन कोड. इसका इस्तेमाल |
long_title |
ज़रूरी है. प्रमोशन के लिए बड़ा टाइटल. |
coupon_value_type |
ज़रूरी है. कूपन वैल्यू टाइप एट्रिब्यूट से पता चलता है कि किस तरह का प्रमोशन किया जा रहा है. कूपन की चुनी गई वैल्यू किस तरह की है उसके आधार पर कुछ एट्रिब्यूट ज़रूरी हैं. |
promotion_destinations[] |
ज़रूरी है. उन डेस्टिनेशन की सूची जिन पर प्रमोशन लागू होता है. अगर डेटा सोर्स में इस्तेमाल की जा सकने वाली वैल्यू को शामिल करके, किसी डेस्टिनेशन की जानकारी नहीं दी जाती है, तो आपका प्रमोशन डिफ़ॉल्ट रूप से, शॉपिंग विज्ञापनों और मुफ़्त में दिखाई जाने वाली लिस्टिंग में दिखेगा. ऐसा हो सकता है कि आपने इससे पहले, अपने प्रॉडक्ट के डेस्टिनेशन के तौर पर ये वैल्यू सबमिट की हों: Shopping Actions, Surfaces across Google, Local surfaces across Google. इन वैल्यू को दिखाने के लिए, |
item_id_inclusion[] |
ज़रूरी नहीं. प्रमोशन के लिए आइटम आईडी के हिसाब से प्रॉडक्ट फ़िल्टर करें. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन के लिए ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट के लिए |
brand_inclusion[] |
ज़रूरी नहीं. प्रमोशन के लिए, ब्रैंड के हिसाब से प्रॉडक्ट फ़िल्टर करें. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन के लिए ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट के लिए |
item_group_id_inclusion[] |
ज़रूरी नहीं. प्रमोशन के लिए, सामान के ग्रुप के आईडी के हिसाब से प्रॉडक्ट फ़िल्टर करें. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन में शामिल होने की ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट [product_applicability] एट्रिब्यूट की वैल्यू, specific_products के तौर पर सेट होती है. |
product_type_inclusion[] |
ज़रूरी नहीं. प्रमोशन के लिए प्रॉडक्ट टाइप के हिसाब से प्रॉडक्ट फ़िल्टर करें. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन के लिए ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट के लिए |
item_id_exclusion[] |
ज़रूरी नहीं. प्रमोशन के लिए, आइटम आईडी एक्सक्लूज़न के हिसाब से प्रॉडक्ट फ़िल्टर करें. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन के लिए ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट के लिए |
brand_exclusion[] |
ज़रूरी नहीं. प्रमोशन के लिए, ब्रैंड एक्सक्लूज़न के हिसाब से प्रॉडक्ट फ़िल्टर करें. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन के लिए ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट के लिए |
item_group_id_exclusion[] |
ज़रूरी नहीं. सामान के ग्रुप के आईडी के हिसाब से प्रॉडक्ट फ़िल्टर. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन में शामिल होने की ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट के लिए |
product_type_exclusion[] |
ज़रूरी नहीं. प्रमोशन के लिए, प्रॉडक्ट टाइप एक्सक्लूज़न के हिसाब से प्रॉडक्ट फ़िल्टर करें. प्रॉडक्ट फ़िल्टर करने वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब प्रमोशन के लिए ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट के लिए |
minimum_purchase_amount |
ज़रूरी नहीं. प्रमोशन को रिडीम करने के लिए, खरीदारी की कम से कम कीमत. |
minimum_purchase_quantity |
ज़रूरी नहीं. प्रमोशन को रिडीम करने के लिए, प्रॉडक्ट की कम से कम संख्या. |
limit_quantity |
ज़रूरी नहीं. प्रमोशन को रिडीम करने के लिए, प्रॉडक्ट की खरीदी जा सकने वाली ज़्यादा से ज़्यादा संख्या. |
limit_value |
ज़रूरी नहीं. प्रमोशन के लिए, प्रॉडक्ट की ज़्यादा से ज़्यादा कीमत. |
percent_off |
ज़रूरी नहीं. प्रमोशन में ऑफ़र की गई छूट का प्रतिशत. |
money_off_amount |
ज़रूरी नहीं. प्रमोशन के तहत ऑफ़र की गई छूट की रकम. |
get_this_quantity_discounted |
ज़रूरी नहीं. प्रमोशन में छूट वाले आइटम की संख्या. एट्रिब्यूट तब सेट होता है, जब |
free_gift_value |
ज़रूरी नहीं. प्रमोशन के लिए, मुफ़्त उपहार की वैल्यू. |
free_gift_description |
ज़रूरी नहीं. प्रमोशन के लिए, मुफ़्त उपहार का ब्यौरा. |
free_gift_item_id |
ज़रूरी नहीं. प्रमोशन के लिए, मुफ़्त उपहार का आइटम आईडी. |
promotion_effective_time_period |
ज़रूरी है. |
promotion_display_time_period |
ज़रूरी नहीं. प्रमोशन के दिखने की तारीख के बारे में |
store_applicability |
ज़रूरी नहीं. क्या प्रमोशन सभी स्टोर पर लागू होता है या सिर्फ़ चुनिंदा स्टोर पर. अगर स्टोर में प्रमोशन करने के लिए किसी स्टोर को लागू नहीं किया जाता है, तो स्थानीय इन्वेंट्री विज्ञापनों के प्रमोशन में गड़बड़ी हो सकती है. अगर |
store_codes_inclusion[] |
ज़रूरी नहीं. प्रमोशन के लिए, शामिल किए जाने वाले स्टोर कोड. स्टोर फ़िल्टर वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब जिस स्टोर में प्रॉडक्ट बेचा जाता है उसका स्टोर कोड (आपकी Business Profile पर दिया गया स्टोर आईडी). ज़्यादा जानकारी के लिए, स्थानीय प्रॉडक्ट इन्वेंट्री डेटा स्पेसिफ़िकेशन देखें. |
store_codes_exclusion[] |
ज़रूरी नहीं. प्रमोशन के लिए, वे स्टोर कोड जिन्हें शामिल नहीं करना है. स्टोर फ़िल्टर वाले एट्रिब्यूट सिर्फ़ तब लागू होते हैं, जब |
promotion_url |
ज़रूरी नहीं. कारोबारी या कंपनी की साइट के उस पेज का यूआरएल जहां प्रमोशन दिखाया जाता है. अगर |
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_source |
ज़रूरी है. प्रमोशन फ़ॉर्मैट का डेटा सोर्स: |
ListPromotionsRequest
ListPromotions
तरीके के लिए अनुरोध से जुड़ा मैसेज.
फ़ील्ड | |
---|---|
parent |
ज़रूरी है. वह खाता जिसके लिए प्रोसेस किए गए प्रमोशन की सूची बनानी है. फ़ॉर्मैट: |
page_size |
सिर्फ़ आउटपुट के लिए. लौटाए जाने वाले प्रमोशन की ज़्यादा से ज़्यादा संख्या. सेवा इस वैल्यू से कम वैल्यू दिखा सकती है. सबसे ज़्यादा वैल्यू 1,000 है. वहीं, 1,000 से ज़्यादा वैल्यू को 1,000 बना दिया जाएगा. अगर यह जानकारी नहीं दी गई है, तो ज़्यादा से ज़्यादा कितने प्रमोशन दिखाए जा सकते हैं. |
page_token |
सिर्फ़ आउटपुट के लिए. पिछले पेजों पर नंबर डालते समय, |
ListPromotionsResponse
ListPromotions
तरीके के लिए रिस्पॉन्स मैसेज.
फ़ील्ड | |
---|---|
promotions[] |
बताए गए खाते के प्रोसेस किए गए प्रमोशन. |
next_page_token |
एक टोकन, जिसे अगला पेज फिर से पाने के लिए |
OfferType
प्रमोशन के लिए ऑफ़र टाइप.
Enums | |
---|---|
OFFER_TYPE_UNSPECIFIED |
ऑफ़र के टाइप की जानकारी नहीं है. |
NO_CODE |
कोड के बिना ऑफ़र का टाइप. |
GENERIC_CODE |
कोड के साथ ऑफ़र का टाइप. offerType = GENERIC_CODE होने पर, प्रमोशन के लिए सामान्य रिडेंप्शन कोड देना ज़रूरी है. |
ProductApplicability
प्रमोशन किस प्रॉडक्ट या प्रॉडक्ट की सूची पर लागू होता है.
Enums | |
---|---|
PRODUCT_APPLICABILITY_UNSPECIFIED |
इस बात की जानकारी नहीं है कि प्रमोशन किन प्रॉडक्ट पर लागू होगा. |
ALL_PRODUCTS |
सभी प्रॉडक्ट पर लागू. |
SPECIFIC_PRODUCTS |
यह सिर्फ़ एक प्रॉडक्ट या प्रॉडक्ट की लिस्ट पर लागू होता है. |
प्रमोशन
यह प्रमोशन को दिखाता है. ज़्यादा जानकारी के लिए, ये लेख पढ़ें.
डेटा की पुष्टि करने से जुड़ी जांच पास करने के लिए, प्रमोशन से जुड़े इनपुट एट्रिब्यूट के लिए ज़रूरी शर्तें मुख्य रूप से यहां बताई गई हैं:
प्रमोशन को शामिल करने के बाद, उसे अपडेट करने के बाद फ़ाइनल प्रमोशन को वापस पाने में कुछ मिनट लग सकते हैं.
फ़ील्ड | |
---|---|
name |
आइडेंटिफ़ायर. प्रचार का नाम. फ़ॉर्मैट: |
promotion_id |
ज़रूरी है. उपयोगकर्ता की ओर से प्रमोशन आईडी दिया गया है, ताकि प्रमोशन की खास तरह से पहचान की जा सके. प्रमोशन को अस्वीकार होने से बचाने के लिए, ज़रूरी शर्तें पूरी करें. |
content_language |
ज़रूरी है. प्रमोशन के लिए, दो अक्षर वाला ISO 639-1 भाषा कोड. प्रमोशन सिर्फ़ चुनिंदा भाषाओं के लिए हैं. |
target_country |
ज़रूरी है. टारगेट किया गया देश, जिसका इस्तेमाल यूनीक आइडेंटिफ़ायर के तौर पर किया जाता है. इसे देश/इलाके के CLDR कोड के तौर पर दिखाया जाता है. प्रमोशन सिर्फ़ चुनिंदा देशों में उपलब्ध हैं. साथ ही, मुफ़्त में दिखाई जाने वाली लिस्टिंग और शॉपिंग विज्ञापन स्थानीय इन्वेंट्री विज्ञापन में भी उपलब्ध हैं |
redemption_channel[] |
ज़रूरी है. प्रमोशन के लिए रिडीम करने का चैनल. कम से कम एक चैनल का होना ज़रूरी है. |
data_source |
सिर्फ़ आउटपुट के लिए. प्रमोशन का प्राइमरी डेटा सोर्स. |
attributes |
ज़रूरी नहीं. प्रमोशन एट्रिब्यूट की सूची. |
custom_attributes[] |
ज़रूरी नहीं. कस्टम (व्यापारी/कंपनी/कारोबारी की ओर से दिए गए) एट्रिब्यूट की सूची. इसका इस्तेमाल, डेटा स्पेसिफ़िकेशन के किसी भी एट्रिब्यूट को उसके जेनरिक रूप में सबमिट करने के लिए भी किया जा सकता है. जैसे, |
promotion_status |
सिर्फ़ आउटपुट के लिए. प्रमोशन की स्थिति, डेटा की पुष्टि से जुड़ी समस्याएं, यानी प्रमोशन के बारे में ऐसी जानकारी जिसे एसिंक्रोनस तरीके से कंप्यूट किया गया है. |
version_number |
ज़रूरी नहीं. यह प्रमोशन के मौजूदा वर्शन (नयापन) को दिखाता है. एक ही समय में कई अपडेट करने पर, इसका इस्तेमाल सही क्रम को बनाए रखने के लिए किया जा सकता है. अगर यह नीति सेट की जाती है, तो मौजूदा प्रमोशन के मौजूदा वर्शन के नंबर से कम होने पर, शामिल नहीं किया जा सकता. मौजूदा अगर कार्रवाई को रोका जाता है, तो रद्द किया गया अपवाद लागू कर दिया जाएगा. |
PromotionStatus
प्रमोशन की स्थिति.
फ़ील्ड | |
---|---|
destination_statuses[] |
सिर्फ़ आउटपुट के लिए. प्रमोशन के लिए टारगेट किए गए डेस्टिनेशन. |
item_level_issues[] |
सिर्फ़ आउटपुट के लिए. प्रमोशन से जुड़ी समस्याओं की सूची. |
creation_date |
सिर्फ़ आउटपुट के लिए. वह तारीख जब ISO 8601 फ़ॉर्मैट में प्रमोशन बनाया गया है: तारीख, समय, और ऑफ़सेट, जैसे कि |
last_update_date |
सिर्फ़ आउटपुट के लिए. ISO 8601 फ़ॉर्मैट में, प्रमोशन की स्थिति को आखिरी बार अपडेट करने की तारीख: तारीख, समय, और ऑफ़सेट, जैसे कि |
DestinationStatus
बताए गए डेस्टिनेशन के लिए स्टेटस.
फ़ील्ड | |
---|---|
reporting_context |
सिर्फ़ आउटपुट के लिए. प्रमोशन दिखाने वाले डेस्टिनेशन का नाम. |
status |
सिर्फ़ आउटपुट के लिए. बताए गए डेस्टिनेशन के लिए स्टेटस. |
स्थिति
प्रमोशन की मौजूदा स्थिति.
Enums | |
---|---|
STATE_UNSPECIFIED |
प्रमोशन की स्थिति की जानकारी नहीं है. |
IN_REVIEW |
प्रमोशन की समीक्षा की जा रही है. |
REJECTED |
प्रमोशन को अस्वीकार कर दिया गया है. |
LIVE |
प्रमोशन को मंज़ूरी मिल गई है और वह चालू है. |
STOPPED |
कारोबारी या कंपनी ने प्रमोशन रोक दिया है. |
EXPIRED |
यह प्रमोशन अब चालू नहीं है. |
PENDING |
प्रमोशन को रोका नहीं गया है और सभी समीक्षाओं को मंज़ूरी मिल गई है. हालांकि, इसके चालू होने की तारीख आगे की है. |
ItemLevelIssue
प्रमोशन से जुड़ी समस्या.
फ़ील्ड | |
---|---|
code |
सिर्फ़ आउटपुट के लिए. समस्या का गड़बड़ी कोड. |
severity |
सिर्फ़ आउटपुट के लिए. इस समस्या से प्रमोशन दिखाने पर क्या असर पड़ता है. |
resolution |
सिर्फ़ आउटपुट के लिए. कारोबारी या कंपनी इस समस्या को हल कर सकती है या नहीं. |
attribute |
सिर्फ़ आउटपुट के लिए. एट्रिब्यूट का नाम, अगर समस्या किसी एक एट्रिब्यूट की वजह से हुई है. |
reporting_context |
सिर्फ़ आउटपुट के लिए. वह डेस्टिनेशन जिस पर समस्या लागू होती है. |
description |
सिर्फ़ आउटपुट के लिए. समस्या के बारे में अंग्रेज़ी में कम शब्दों में जानकारी. |
detail |
सिर्फ़ आउटपुट के लिए. समस्या के बारे में पूरी जानकारी अंग्रेज़ी में. |
documentation |
सिर्फ़ आउटपुट के लिए. इस समस्या को हल करने में मदद करने के लिए, वेब पेज का यूआरएल. |
applicable_countries[] |
सिर्फ़ आउटपुट के लिए. उन देशों के कोड की सूची (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 |
प्रमोशन सिर्फ़ चुनिंदा स्टोर पर लागू होता है. |