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

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 में प्रमोशन के तरीकों की उपलब्धता की तुलना की गई है:

सुविधा Content API for Shopping 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 में प्रमोशन के लिए क्या बदलाव किए गए हैं.

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

Content API for Shopping 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,
    ]
    }
  ]
}