บริการสินค้าคงคลังในร้าน

บริการสินค้าคงคลังในร้านช่วยให้คุณสร้างและอัปเดตอินสแตนซ์ของทรัพยากรสินค้าคงคลังในร้านซึ่งมีช่องที่อาจมีค่าแตกต่างกันสำหรับสถานที่ตั้งกิจการที่มีหน้าร้านจริงที่แตกต่างกัน อินสแตนซ์สินค้าคงคลังในร้านแต่ละรายการเป็นบัญชีย่อยของทรัพยากรผลิตภัณฑ์ที่มีอยู่ และรับค่าช่องข้อมูลผลิตภัณฑ์จากทรัพยากรหลัก เช่น คุณอาจมีผลิตภัณฑ์ที่มีราคาและจำนวนต่างกันในร้านค้าต่างๆ แต่แชร์รหัส รายละเอียด และข้อมูลผลิตภัณฑ์อื่นๆ ในร้านค้าทั้งหมด ระบบจะใช้ข้อมูลสินค้าคงคลังในร้านสำหรับโปรแกรม Surfaces across Google และโฆษณาสินค้าคงคลังในร้าน

คู่มือนี้จะอธิบายสิ่งที่คุณต้องมีก่อนที่จะเริ่มใช้บริการสินค้าคงคลังในร้าน อธิบายช่องและวิธีการใช้งานต่างๆ ที่มีให้ รวมถึงแสดงตัวอย่างคำขอบริการ

หมายเหตุ: ใน Content API เวอร์ชัน 2.1 บริการสินค้าคงคลังในร้านและฟีดเสริมจะมาแทนที่บริการสินค้าคงคลังในเวอร์ชัน 2 หากต้องการอัปเดตข้อมูลผลิตภัณฑ์ที่ไม่ใช่ในพื้นที่บางส่วนด้วย API v2.1 ให้ใช้ฟีดเสริม หากต้องการอัปเดตผลิตภัณฑ์ในร้านเพิ่มเติม ให้ใช้บริการ localinventory

ข้อกำหนดเบื้องต้น

• หากต้องการใช้บริการสินค้าคงคลังในร้าน คุณต้องสร้าง Business Profile, ลิงก์ Business Profile กับบัญชี Merchant Center, ยืนยันธุรกิจ และตั้งค่ารหัสร้านค้า Business Profile

• คุณต้องลงทะเบียนบัญชี Merchant Center ในโปรแกรมในพื้นที่ ซึ่งได้แก่ แพลตฟอร์มในพื้นที่ของ Google หรือโฆษณาสินค้าคงคลังในร้าน ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้โฆษณาสินค้าคงคลังในร้านผ่าน Content API ได้ที่เริ่มต้นใช้งานโฆษณาสินค้าคงคลังในร้าน

  หมายเหตุ: หากบัญชี Merchant Center ไม่ได้ลงทะเบียนในโปรแกรมในพื้นที่ การตั้งค่าช่อง channel ของผลิตภัณฑ์เป็น local ผ่านเมธอด Products.insert ระบบจะแสดงข้อผิดพลาดว่า "channel ช่องทางไม่ถูกต้อง: ในพื้นที่"

• บริการสินค้าคงคลังในร้านจะสร้างอินสแตนซ์สินค้าคงคลังในร้านสำหรับผลิตภัณฑ์ในร้านที่มีอยู่ ก่อนอื่นคุณต้องสร้างผลิตภัณฑ์ในร้านโดยใช้บริการผลิตภัณฑ์ Content API หรือ datafeeds ของ Merchant Center โดยการสร้างช่อง channel เป็น local จากนั้นคุณจะใช้บริการสินค้าคงคลังในร้านเพื่อสร้างอินสแตนซ์สินค้าคงคลังในร้านสำหรับ Business Profile storecode แต่ละรายการที่มีการขายผลิตภัณฑ์ได้

ช่อง

อินสแตนซ์สินค้าคงคลังในร้านแต่ละรายการจะมีชุดช่องที่เชื่อมโยงกับตำแหน่งร้านค้าที่เจาะจงผ่านช่อง storeCode (ซึ่งคุณกำหนดไว้ใน Business Profile) เฉพาะ storecode และ productId เท่านั้นที่ต้องระบุสำหรับคำขอทั้งหมด ช่องอื่นๆ ทั้งหมดเป็นตัวเลือก:

• ต้องระบุสำหรับคำขอทั้งหมด: storeCode, productId (ใน URL)
• ไม่บังคับ: quantity, price, salePrice, salePriceEffectiveDate, availability, pickupMethod, pickupSla, instoreProductLocation

ดูรายการช่องสินค้าคงคลังในร้านและคำอธิบายทั้งหมดได้ในหน้าอ้างอิงสินค้าคงคลังในร้าน

วิธีการ

บริการสินค้าคงคลังในร้านมี 2 วิธีเท่านั้น ดังนี้

localinventory.insert

localinventory.insert ให้คุณสร้างอินสแตนซ์สินค้าคงคลังในร้านสำหรับผลิตภัณฑ์ในร้านรายการเดียว

ตัวอย่างนี้แสดงวิธีใช้บริการสินค้าคงคลังในร้านเพื่อสร้างการลดราคาในร้านค้า ตั้งแต่วันที่ 24 กุมภาพันธ์ 2021 เวลา 13:00 น. (GMT-8) จนถึงวันที่ 28 กุมภาพันธ์ 2021 เวลา 15:30 น. (GMT-8) นอกจากนี้ คำขอจะอัปเดตจำนวนที่พร้อมใช้งานสำหรับอินสแตนซ์สินค้าคงคลังในร้านด้วย ช่องที่ไม่ได้รวมอยู่ในเนื้อหาของคำขอจะถูกเขียนทับโดยการเรียกนี้ ซึ่งต่างจากฟีดเสริมสำหรับข้อมูลผลิตภัณฑ์ในร้านที่ไม่ได้รวมอยู่

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId/localinventory

{
  "storeCode": “1235”,
  "salePrice": {
     "value": “100.00”,
     "currency": “USD”
   },
  "salePriceEffectiveDate": “2021-02-24T13:00-0800/2021-02-28T15:30-0800”,
  "quantity": 200,
}

localinventory.custombatch

localinventory.custombatch ช่วยให้คุณสร้างอินสแตนซ์สินค้าคงคลังในร้านหลายรายการสำหรับผลิตภัณฑ์ในร้านรายการเดียวในร้านค้าหลายแห่ง หรือสร้างอินสแตนซ์สินค้าคงคลังในร้านหลายรายการสำหรับผลิตภัณฑ์ในร้านหลายรายการ

หมายเหตุ: คุณจะเรียกข้อมูล แสดงรายการ หรือลบอินสแตนซ์สินค้าคงคลังในร้านไม่ได้ หากต้องการดูข้อมูลสินค้าคงคลังในร้านใน Merchant Center ให้เลือกผลิตภัณฑ์ในร้านในหน้าผลิตภัณฑ์ทั้งหมด แล้วขยายส่วนสินค้าคงคลังในร้าน ตารางจะแสดงข้อมูลสินค้าคงคลังในร้านสำหรับรหัสร้านค้าแต่ละรายการ