प्रमोशन मैनेजमेंट को माइग्रेट करना

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 में, कीमत
स्ट्रिंग के तौर पर दशमलव संख्या थी.

कीमत की रकम अब माइक्रो में रिकॉर्ड की जाती है.
यहां 10 लाख माइक्रो, आपकी मुद्रा
स्टैंडर्ड यूनिट के बराबर है.

amount फ़ील्ड का नाम, वैल्यू से बदलकर
amountMi Cros कर दिया गया है.

currency फ़ील्ड का नाम बदलकर
currencyCode हो गया है. फ़ॉर्मैट,
ISO 4217 के तौर पर बना रहता है. (विकिपीडिया)

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,
    ]
    }
  ]
}