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."