custombatch เป็นวิธีที่ใช้บ่อยซึ่งช่วยให้คุณจัดกลุ่มการเรียก API หลายรายการหรือที่เรียกว่า "รายการ" ไว้ในคำขอ HTTP รายการเดียวได้ แต่ละรายการจะอ้างอิง
การเรียกเมธอดเดียวเท่านั้น
กลุ่มที่กำหนดเองเป็นตัวเลือกที่ดีในกรณีต่อไปนี้
- คุณเพิ่งเริ่มใช้ API และมีข้อมูลผลิตภัณฑ์จำนวนมากที่ต้องอัปโหลด
- คุณต้องซิงค์ข้อมูลในเครื่องกับเซิร์ฟเวอร์โดยส่งการอัปเดตและลบจำนวนมาก
สร้างคำขอแบบกลุ่ม
การส่งคำขอแบบกลุ่มคล้ายกับการส่งการเรียก API พร้อมกัน โปรดทราบว่าไม่มีการรับประกันว่ารายการลำดับรายการที่ระบุไว้ในคำขอจะอยู่ในลำดับการดำเนินการ เราขอแนะนำว่าอย่าใช้การโทรที่เชื่อมต่อระหว่างกันในคำขอแบบกลุ่มเดียว (เช่น การสร้างและอัปเดตการจัดส่งเดียวกัน)
ในทํานองเดียวกัน การตอบกลับที่ได้รับสำหรับคำขอแบบกลุ่มอาจแสดงผลโดยเรียงลำดับต่างจากรายการคำขอ คุณใช้ BatchId เพื่อเชื่อมโยงคำขอและการตอบกลับได้ เนื่องจากระบบอาจแสดงการตอบกลับตามลำดับ
คุณจัดกลุ่มคำขอใน API ได้ด้วยการเรียกใช้เมธอด custombatch ที่เหมาะสม ดังนี้
| ทรัพยากรและวิธีการแบบกลุ่มที่กำหนดเองที่เกี่ยวข้อง | |
|---|---|
Accounts |
accounts.custombatch |
Accountstatuses |
accountstatuses.custombatch |
Accounttax |
accounttax.custombatch |
Datafeeds |
datafeeds.custombatch |
Datafeedstatuses |
datafeedstatuses.custombatch |
Localinventory |
localinventory.custombatch
|
Liasettings |
liasettings.custombatch |
Pos |
pos.custombatch |
Products |
products.custombatch |
Productstatuses |
productstatuses.custombatch |
Shippingsettings |
shippingsettings.custombatch |
ข้อจำกัด
เราขอแนะนำให้จำกัดขนาดของคำขอ custombatch รายการไว้ที่ไม่เกิน 1,000 รายการเพื่อหลีกเลี่ยงข้อผิดพลาดเมื่ออัปโหลดกลุ่มขนาดใหญ่ จำนวนสูงสุดต่อไปนี้มีผลกับคำขอ custombatch รายการ
- 50,000 รายการต่อ
custombatchคำขอ - ขนาดการโอน 32 MB
การเรียกที่เกินขีดจำกัดสูงสุดจะส่งผลให้เกิดข้อผิดพลาด request_too_large ต่อไปนี้
"Too many requests in a batch.""Request payload size exceeds the limit: %d bytes."