उत्पाद का अपडेट करें#

एक उत्पाद को सिंक्रोनस रूप से अपडेट करता है। उत्पाद की पहचान productId या sku, साथ में shopId के साथ करें। ठीक एक पहचानकर्ता प्रदान करें; दोनों या न ही शामिल अनुरोध 400 Bad Request लौटाते हैं।

http

PATCH https://sdkapi.ideal.house/product-import/products

पहचानकर्ता product ऑब्जेक्ट से अलग है। इससे एकीकरण को उसके वर्तमान SKU द्वारा उत्पाद की पहचान करने और उसी अनुरोध में SKU बदलने की अनुमति मिलती है।

जब SKU बदल रहे हों तो पहचानकर्ता के रूप में productId का उपयोग करें। यदि पहला अनुरोध SKU को अपडेट करता है लेकिन उसका प्रतिक्रिया खो जाता है, तो यह पुनः प्रयासों को अस्पष्टता से मुक्त रखता है।

अनुरोध बॉडी#

फ़ील्ड	प्रकार	आवश्यक	विवरण
`shopId`	string	हाँ	Ideal House द्वारा प्रदान किया गया Shop ID।
`productId`	string	शर्तबद्ध	पहचानने के लिए प्रोडक्ट आईडी। जब `sku` छोड़ा जाता है तो आवश्यक है।
`sku`	string	शर्तबद्ध	पहचानने के लिए वर्तमान SKU। जब `productId` छोड़ा जाए तो आवश्यक है।
`product`	object	हाँ	अपडेट करने के लिए फ़ील्ड। कम से कम एक फ़ील्ड शामिल करें।

संपादन योग्य उत्पाद फ़ील्ड#

केवल product में शामिल फ़ील्ड अपडेट होती हैं।

फ़ील्ड	प्रकार	अधिकतम लंबाई	विवरण
`sku`	string	120	नया SKU। इसका दुकान के भीतर अद्वितीय रहना चाहिए।
`externalProductId`	string	120	बाहरी उत्पाद पहचानकर्ता।
`groupId`	string	120	उत्पाद समूह पहचानकर्ता।
`collectionId`	string	120	उत्पाद संग्रह पहचानकर्ता।
`name`	string	255	उत्पाद का नाम।
`title`	string	255	उत्पाद प्रदर्शन शीर्षक।
`brand`	string	120	उत्पाद ब्रांड।
`productType`	string	120	आपके वर्गीकरण में उत्पाद प्रकार।
`normalizedProductType`	string	40	सामान्यीकृत उत्पाद प्रकार। समर्थित मानों के लिए Ideal House से समन्वय करें।
`category`	string	120	उत्पाद श्रेणी।
`style`	string	120	उत्पाद शैली।
`color`	string	120	उत्पाद रंग।
`availability`	string	40	उपलब्धता मान।
`imageUrl`	string	1,000	सार्वजनिक HTTP या HTTPS स्रोत-चित्र URL।
`previewImageUrl`	string	1,000	HTTP या HTTPS पूर्वावलोकन-चित्र URL।
`productUrl`	string	1,000	HTTP या HTTPS उत्पाद-विवरण URL।
`attributes`	object	—	उत्पाद विशेषताएँ। जब प्रदान किया जाए, यह ऑब्जेक्ट वर्तमान विशेषताओं ऑब्जेक्ट को बदल देता है।
`status`	string	—	उत्पाद स्थिति। अपडेट एंडपॉइंट `active` या `inactive` को स्वीकार करता है।

निम्नलिखित फ़ील्ड केवल-पठन हैं: id, shopId, productCode, createdAt, और updatedAt। उत्पाद को invalid सेट करने के लिए हटाने एंडपॉइंट का उपयोग करें।

SKU द्वारा अपडेट करें#

json

{
  "shopId": "shop_123",
  "sku": "SKU-10001",
  "product": {
    "name": "Large Gold Wall Mirror",
    "color": "Antique Gold",
    "status": "active"
  }
}

bash

curl --request PATCH \
  'https://sdkapi.ideal.house/product-import/products' \
  --header 'Content-Type: application/json' \
  --header 'X-Client-Id: <YOUR_CLIENT_ID>' \
  --header 'X-Client-Secret: <YOUR_CLIENT_SECRET>' \
  --data-raw '{
    "shopId": "shop_123",
    "sku": "SKU-10001",
    "product": {
      "name": "Large Gold Wall Mirror",
      "color": "Antique Gold",
      "status": "active"
    }
  }'

प्रोडक्ट आईडी से अपडेट करें और SKU बदलें#

json

{
  "shopId": "shop_123",
  "productId": "product_123",
  "product": {
    "sku": "SKU-10001-NEW",
    "name": "Large Gold Wall Mirror",
    "status": "inactive"
  }
}

सफल अपडेट 200 OK और पूर्ण अपडेट किया गया प्रोडक्ट ऑब्जेक्ट लौटाना है। एक inactive प्रोडक्ट संरक्षित रहता है और List Products एंडपॉइंट के माध्यम से उपलब्ध रहता है।