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

Google पर कारोबारियों की ओर से छूट बनाने और उन्हें मैनेज करने के लिए, Merchant Promotions API का इस्तेमाल किया जा सकता है. accounts.promotions रिसॉर्स की मदद से, Google पर बेचे जाने वाले प्रॉडक्ट के लिए खास ऑफ़र दिखाए जा सकते हैं. ज़्यादा जानकारी के लिए, Merchant Promotions API के बारे में खास जानकारी लेख पढ़ें.

Content API for Shopping से Merchant API पर माइग्रेट करने पर होने वाले बदलावों की खास जानकारी

एक अहम अंतर यह है कि Content API for Shopping, पहली बार प्रमोशन जोड़ने पर डेटा सोर्स अपने-आप बना देता है. हालांकि, Merchant API में ऐसा नहीं होता. Merchant API का इस्तेमाल करके प्रमोशन जोड़ने के लिए, आपको सबसे पहले प्रमोशन की जानकारी वाला डेटा सोर्स बनाना होगा.

accounts.dataSources रिसॉर्स में promotionDataSource ऑब्जेक्ट के फ़ील्ड के बारे में जानकारी पाने के लिए, PromotionDataSource देखें.

मौजूदा डेटा सोर्स

मौजूदा डेटा सोर्स के लिए, अगर आपको अपना accounts.dataSources.name नहीं पता है, तो उसे वापस पाने के लिए dataSources.list का इस्तेमाल करें.

इसके अलावा, अपने हर प्रमोशन के लिए डेटा सोर्स की पहचान करने के लिए, accounts.promotions.get तरीके का इस्तेमाल करें. साथ ही, अपने खाते में मौजूद किसी भी प्रमोशन के रिस्पॉन्स में, dataSource फ़ील्ड की जांच करें.

हमारा सुझाव है कि आप हर प्रमोशन के लिए, accounts.dataSources.name को अपने लोकल डेटाबेस में सेव करें. इससे, आने वाले समय में एपीआई कॉल में उन्हें सीधे तौर पर रेफ़र किया जा सकेगा.

अनुरोध

अनुरोध करने के लिए, इस यूआरएल का इस्तेमाल करें.

POST https://merchantapi.googleapis.com/promotions/v1/{ACCOUNT_NAME}/promotions

Content API for Shopping से माइग्रेट करना

यहां Content API for Shopping और Merchant Promotions API की तुलना की गई है. इससे आपको प्रमोशन से जुड़े अनुरोधों के बारे में जानकारी मिलेगी.

URL

Content API for Shopping में:

https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions

Merchant API में इस तरह दिखेगा:

https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions

आइडेंटिफ़ायर

Content API for Shopping में:

{MERCHANT_ID}/promotions/{PROMOTION_ID}

Merchant API में इस तरह दिखेगा:

{NAME}

तरीके

Merchant API, प्रमोशन के लिए इन तरीकों का इस्तेमाल करता है:

  • प्रमोशन शामिल करना
  • प्रमोशन पाएं
  • प्रमोशन की सूची बनाना

यहां Content API for Shopping और Merchant API में, प्रमोशन के तरीकों की उपलब्धता की तुलना की गई है:

सुविधा Shopping के लिए Content API Merchant API
यूआरएल https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions
आइडेंटिफ़ायर {MERCHANT_ID}/promotions/{PROMOTION_ID} {NAME}
तरीके
  • insert
  • get
  • list
  • customBatch
  • delete
  • insert
  • get
  • list

फ़ील्ड में बदलाव

इस टेबल में बताया गया है कि Merchant Promotions API में, प्रमोशन के लिए क्या बदलाव हुए हैं.

रेफ़रंस के तौर पर उदाहरण देखने के लिए, accounts.promotions पर जाएं.

Shopping के लिए Content API Merchant API ब्यौरा
(समर्थित नहीं है) custom_attributes कस्टम (उपयोगकर्ता से मिले) एट्रिब्यूट की सूची.
इसका इस्तेमाल, फ़ीड की खास बातों में दिए गए किसी भी एट्रिब्यूट को
उसके सामान्य फ़ॉर्मैट में सबमिट करने के लिए भी किया जा सकता है.
उदाहरण के लिए: 
{
  "name": "size type", "value": "regular"
}
यह उन एट्रिब्यूट को सबमिट करने के लिए काम का है जिन्हें एपीआई साफ़ तौर पर
नहीं दिखाता.
ये काम नहीं करते हैं data_source प्रमोशन बनाने के लिए, कोई मौजूदा डेटा सोर्स होना ज़रूरी है.
ये काम नहीं करते हैं attributes प्रमोशन के लिए खास एट्रिब्यूट, जैसे कि
long_tile, promotion_effective_timeperiod,
और अन्य एट्रिब्यूट, एट्रिब्यूट मैसेज का हिस्सा होते हैं.
item_id item_id_inclusion जिस प्रमोशन को आइटम आईडी की सूची पर लागू किया गया है उसका नाम बदल दिया गया है.
store_id store_id_inclusion उन स्टोर आईडी की सूची का नाम बदल दिया गया है
जिन पर प्रमोशन लागू होता है.
product_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)
  }
कीमत एट्रिब्यूट की परिभाषा बदल गई है.

Content API for Shopping में, Price
स्ट्रिंग के तौर पर एक दशमलव संख्या थी.

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

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

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,
    ]
    }
  ]
}
पीछे जाएं
Migrate order tracking signals
आगे बढ़ें
Migrate conversion sources management