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

Merchant Promotions API का इस्तेमाल करके, Google पर प्रमोशन बनाए और मैनेज किए जा सकते हैं. 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 में, कीमत
एक स्ट्रिंग के तौर पर दशमलव संख्या होती थी.

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

amount फ़ील्ड का नाम, value से बदलकर
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