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

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 देखें.

अनुरोध

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

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
  • delete

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

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

रेफ़रंस के लिए उदाहरण देखने के लिए, स्थानीय इन्वेंट्री देखें.

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 फ़ील्ड का नाम, 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,
    ]
    }
  ]
}