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 - גודל העברה של 32MB
אם תחרגו מהמגבלות האלה, תקבלו את השגיאות הבאות: request_too_large
"Too many requests in a batch.""Request payload size exceeds the limit: %d bytes."