Google पर प्रमोशन बनाने और उन्हें मैनेज करने के लिए, Merchant प्रमोशन एपीआई का इस्तेमाल किया जा सकता है. accounts.promotions संसाधन की मदद से, Google पर बेचे जाने वाले प्रॉडक्ट के लिए खास ऑफ़र दिखाए जा सकते हैं. ज़्यादा जानकारी के लिए, Merchant प्रमोशन एपीआई की खास जानकारी देखें.
अनुरोध
अनुरोध करने के लिए, इस यूआरएल का इस्तेमाल करें.
POST https://merchantapi.googleapis.com/promotions/v1beta/{account_name}/promotions
Content API for Shopping से माइग्रेट करना
यहां दिए गए उदाहरण में, प्रमोशन से जुड़े अनुरोधों के लिए, Content API for Shopping की तुलना 'मर्चेंट प्रमोशन एपीआई' से की गई है.
यूआरएल
Shopping के लिए Content API में:
https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/promotions
में बदल जाता है:
https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions
आइडेंटिफ़ायर
Shopping के लिए Content API में:
{merchantId}/promotions/{promotionId}
में बदल जाता है:
{name}
तरीके
Merchant API, प्रमोशन के लिए इन तरीकों के साथ काम करता है:
- प्रमोशन डालें
- प्रमोशन पाएं
- प्रमोशन की सूची बनाएं
यहां Shopping के लिए Content API और Merchant API में, प्रमोशन के तरीकों की उपलब्धता की तुलना की गई है:
तरीका | Shopping के लिए Content API | मर्चेंट एपीआई |
---|---|---|
डालें | हां | हां |
पाएं | हां | हां |
list | हां | हां |
customBatch | नहीं | नहीं |
मिटाएं | नहीं | (तय किया जाना बाकी है) |
संसाधन नाम
इस टेबल से पता चलता है कि Merchant प्रमोशन एपीआई में, प्रमोशन में क्या बदलाव किए गए हैं.
रेफ़रंस के लिए कोई उदाहरण देखने के लिए, स्थानीय इन्वेंट्री देखें.
Shopping के लिए Content API | मर्चेंट एपीआई | कंपनी का ब्यौरा |
---|---|---|
(समर्थित नहीं है) | custom_attributes |
कस्टम (व्यापारी/कंपनी/कारोबारी की ओर से दिए गए) एट्रिब्यूट की सूची. का इस्तेमाल, फ़ीड के किसी भी एट्रिब्यूट के लिए एट्रिब्यूट को सामान्य रूप में सबमिट करने के लिए भी किया जा सकता है. उदाहरण के लिए: { "name": "size type", "value": "regular" }यह उन एट्रिब्यूट को सबमिट करने के लिए मददगार है जिन्हें साफ़ तौर पर एपीआई में नहीं दिखाया गया है. |
इनकी अनुमति नहीं है | data_source | प्रमोशन बनाने के लिए, किसी मौजूदा डेटा सोर्स की ज़रूरत होती है. |
इनकी अनुमति नहीं है | एट्रिब्यूट |
प्रमोशन से जुड़े एट्रिब्यूट, एट्रिब्यूट मैसेज का हिस्सा होते हैं. उदाहरण के लिए,
long_tile, long_tile, वगैरह. |
item_id | item_id_inclusion |
प्रमोशन वाले आइटम आईडी की
सूची का नाम बदलकर कर दिया जाता है. |
store_id | store_id_inclusion |
ऐसे स्टोर आईडी की सूची का नाम बदल दिया गया है जिन पर प्रमोशन
लागू होता है. |
prduct_type | product_type_inclusion |
ऐसे प्रॉडक्ट टाइप की सूची का नाम बदल दिया गया है जिन पर प्रमोशन
लागू होता है. |
item_group_id | item_group_id_inclusion |
सामान के ग्रुप के जिन आईडी पर प्रमोशन को
लागू किया जाता है उनकी सूची का नाम बदल दिया जाता है. |
brand | brand_inclusion |
जिन ब्रैंड पर प्रमोशन लागू होता है उनकी सूची
का नाम बदल दिया गया है. |
store_code | store_codes_inclusion |
प्रमोशन के लिए इस्तेमाल किए जाने वाले स्टोर कोड की सूची का नाम,
कर दिया गया है. |
price: { object (Price) } |
price: { object (Price) } |
Price की परिभाषा बदल गई है.
Content API for Shopping में, कीमत
कीमत की रकम अब माइक्रो में रिकॉर्ड की जाती है.
amount फ़ील्ड का नाम, वैल्यू से बदलकर
currency फ़ील्ड का नाम बदलकर
|
order_limit | (समर्थित नहीं है) | order_limit एट्रिब्यूट का इस्तेमाल नहीं किया जा सकता. |
shippingServiceNames[] | (समर्थित नहीं है) | shippingServiceNames[] काम नहीं करते. |
money_budget | (समर्थित नहीं है) | money_budget का इस्तेमाल नहीं किया जा सकता. |
promotion_destination_ids | promotion_destinations | promotionDestinationIds का नाम बदल दिया गया है. |
प्रमोशन की स्थिति
{ "destinationStatuses": [ { "destination": string, "status": enum (State) } ], "promotionIssue": [ { "code": string, "detail": string } ], "creationDate": string, "lastUpdateDate": string } |
प्रमोशन का स्टेटस बदल गया है.
समस्याओं के बारे में ज़्यादा जानकारी उपलब्ध है. promotionStatus = { destinationStatuses = [ { reportingContext = Enum status = Enum }, ], itemLevelIssues = [ { code = String severity = Enum resolution = String reportingContext = Enum description = String detail = String documentation = String applicableCountries = [ String, ] } ] } |