การอัปเดตการกําหนดราคาและความพร้อมใช้งานของผลิตภัณฑ์

หมายเหตุ

API สินค้าคงคลังพร้อมใช้งานสําหรับผู้เข้าร่วมนําร่องที่ปิดเท่านั้น API และเอกสารอาจเปลี่ยนแปลงได้

หากคุณจําเป็นต้องอัปเดตราคาและความพร้อมใช้งานของผลิตภัณฑ์ในร้านค้า Bing Merchant Center (BMC) คุณควรใช้ทรัพยากรสินค้าคงคลังแทนทรัพยากรผลิตภัณฑ์ ด้วยทรัพยากรผลิตภัณฑ์ คุณต้องระบุรายละเอียดทั้งหมดของผลิตภัณฑ์ แต่ทรัพยากรสินค้าคงคลังช่วยให้คุณสามารถระบุราคาและความพร้อมใช้งานได้

การอัปเดตผลิตภัณฑ์เดียว

หากต้องการอัปเดตผลิตภัณฑ์เดียว ให้ใช้ /bmc/{bmcMerchantId}/inventory/{storeCode}/products/{productUniqueId} เทมเพลตในคําขอ HTTP POST ตั้งค่า {bmcMerchantId} เป็น ID ร้านค้าของคุณ {storeCode} เป็น ออนไลน์ และ {productUniqueId} เป็น ID ที่ตรงตามหลักเกณฑ์ของผลิตภัณฑ์

เนื้อความของคําขอเป็นวัตถุ ผลิตภัณฑ์ ที่มีเฉพาะเขตข้อมูลต่อไปนี้เท่านั้น:

• ราคา
• ความพร้อมใช้งาน
• salePrice
• salePriceEffectiveDate

priceจําเป็นต้องมีเขตข้อมูล และ availability การเรียกจะล้มเหลวถ้าคุณไม่ได้ระบุเขตข้อมูลทั้งสอง salePriceและ salePriceEffectiveDate เป็นทางเลือก ถ้าคุณไม่ได้ระบุราคาการขายปัจจุบันและค่าวันที่มีผลบังคับใช้ของผลิตภัณฑ์จะถูกลบออกจากข้อเสนอ

ต่อไปนี้แสดงตัวอย่างคําขอ POST

POST https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/1234/inventory/online/products/online:en:US:5678 HTTP/1.1
AuthenticationToken: EwAAA3hl...
DeveloperToken: 0417...
Content-Type: application/json
Host: content.api.bingads.microsoft.com
Content-Length: 73

{
    "availability":"out of stock",
    "price":{
        "currency":"USD",
        "value":1234.0
    }
}

หากคําขอสําเร็จ ระบบจะแสดงรหัสสถานะ 200 และ URI ของผลิตภัณฑ์ที่อัปเดตแล้วในส่วนหัวของตําแหน่งที่ตั้ง

HTTP/1.1 200 OK
Content-Type: application/json
Location: https://content.api.bingads.microsoft.com/shopping.svc/v9.1/bmc/1234/products/online:en:US:5678
WebRequestActivityId: e2c53946-e18c-4302-a40a-6d174429574a
Date: Fri, 09 Nov 2018 20:34:35 GMT
Content-Length: 46

{
  "kind": "content#inventorySetResponse"
}

และถ้าการตอบสนองล้มเหลว คําขอจะส่งกลับรหัสสถานะ 400 เนื้อความประกอบด้วยวัตถุ การตอบสนองข้อผิดพลาด ที่ระบุปัญหา

HTTP/1.1 400 Bad Request
Content-Type: application/json
Location: https://content.api.bingads.microsoft.com/shopping.svc/v9.1/bmc/1234/products/online:en:US:5678
WebRequestActivityId: d3d31a3f-8993-428e-858c-730032e32a46
Date: Sat, 10 Nov 2018 14:35:14 GMT
Content-Length: 305

{
  "error": {
    "errors": [
      {
        "reason": "invalid",
        "message": "Invalid value for: availability, stock is not a valid value",
        "domain": "global"
      }
    ],
    "code": "400",
    "message": "Invalid value for: availability, stock is not a valid value"
  }
}

ตัวอย่างเช่น รหัสที่แสดงวิธีใช้ทรัพยากรสินค้าคงคลังเพื่ออัปเดตผลิตภัณฑ์เดียว ให้ดู การอัปเดตราคาและความพร้อมใช้งานสําหรับผลิตภัณฑ์เดียว

กําลังอัพเดตหลายผลิตภัณฑ์

หากต้องการอัปเดตหลายผลิตภัณฑ์ ให้ใช้ /bmc/{bmcMerchantId}/inventory/batch เทมเพลตในคําขอ HTTP POST ตั้งค่า {bmcMerchantId} เป็น ID ร้านค้าของคุณ

เนื้อความของคําขอเป็นวัตถุ กลุ่ม ที่อาจมีผลิตภัณฑ์ที่จะอัปเดตได้สูงสุด 400 รายการ รายการแต่ละรายการในชุดงานมี ID ชุดงานที่ผู้ใช้กําหนด รหัสร้านค้าที่ตั้งค่าเป็น ออนไลน์ ID ที่ตรงตามหลักเกณฑ์ของผลิตภัณฑ์ และเขตข้อมูลการกําหนดราคาและความพร้อมใช้งานของผลิตภัณฑ์ที่จะอัปเดต วัตถุ Product อาจมีเฉพาะเขตข้อมูลต่อไปนี้เท่านั้น:

• ราคา
• ความพร้อมใช้งาน
• salePrice
• salePriceEffectiveDate

priceจําเป็นต้องมีเขตข้อมูล และ availability การเรียกจะล้มเหลวถ้าคุณไม่ได้ระบุเขตข้อมูลทั้งสอง salePriceและ salePriceEffectiveDate เป็นทางเลือก ถ้าคุณไม่ได้ระบุราคาการขายปัจจุบันและค่าวันที่มีผลบังคับใช้ของผลิตภัณฑ์จะถูกลบออกจากข้อเสนอ

ต่อไปนี้แสดงตัวอย่างคําขอ POST

POST https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/1234/inventory/batch HTTP/1.1
AuthenticationToken: EwAAA3hl...
DeveloperToken: 0417...
Content-Type: application/json
Host: content.api.bingads.microsoft.com
Content-Length: 194

{
    "entries":[
        {
            "batchId":1,
            "storeCode":"online",
            "productId":"online:en:US:5678",
            "inventory":{
                "availability":"in stock",
                "price":{
                    "currency":"USD",
                    "value":4567.0
                }
            }
        },
        {
            "batchId":2,
            "storeCode":"online",
            "productId":"online:en:US:9012",
            "inventory":{
                "availability":"bad in stock",
                "price":{
                    "currency":"USD",
                    "value":678.0
                }
            }
        }
    ]
}

เนื่องจากคําขอพยายามอัปเดตทุกผลิตภัณฑ์ในชุดงาน จึงส่งกลับรหัสสถานะ 200 เมื่อต้องการตรวจสอบว่าการอัปเดตล้มเหลวหรือไม่ คุณจําเป็นต้องทําซ้ําคําสั่งผ่านรายการทั้งหมดในชุดงาน การอัปเดตล้มเหลวหากรายการมี errors เขตข้อมูลมิฉะนั้นจะสําเร็จ

HTTP/1.1 200 OK
Content-Type: application/json
WebRequestActivityId: bf019ef5-fa76-4703-9132-7954b0323c81
Date: Fri, 09 Nov 2018 20:48:15 GMT
Content-Length: 172

{
  "kind": "content#inventoryCustomBatchResponse",
  "entries": [
    {
      "kind": "content#inventoryCustomBatchEntryResponse",
      "batchId": "1"
    },
    {
      "kind": "content#inventoryCustomBatchEntryResponse",
      "batchId": "2",
      "errors": {
        "errors": [
          {
            "reason": "invalid",
            "message": "Invalid value for: availability, bad in stock is not a valid value",
            "domain": "global"
          }
        ]
      }
    }
  ]
}

ตัวอย่างเช่น รหัสที่แสดงวิธีการใช้ทรัพยากรสินค้าคงคลังเพื่ออัพเดตชุดผลิตภัณฑ์ ให้ดู การอัปเดตการกําหนดราคาและความพร้อมใช้งานสําหรับชุดผลิตภัณฑ์

ดูเพิ่มเติม

การจัดการข้อเสนอผลิตภัณฑ์