custombatch היא שיטה נפוצה שמאפשרת לקבץ מספר קריאות ל-API, שנקראות 'ערכים', לבקשת HTTP אחת. כל רשומה מפנה רק
לקריאה ל-method אחת.
אצווה מותאמת אישית היא אפשרות טובה כאשר:
- התחלתם להשתמש ב-API ויש לכם הרבה נתוני מוצרים להעלאה.
- אתם צריכים לסנכרן את הנתונים המקומיים עם השרת באמצעות שליחת עדכונים ומחיקה רבים.
שליחת בקשות בכמות גדולה
שליחת בקשות בכמות גדולה דומה לשליחת קריאות ל-API במקביל. חשוב לזכור שאין ערובה לכך שסדר הרשומות שמוגדר בבקשה יהיה לפי סדר ביצוען. מומלץ לא להשתמש בקריאות הדדיות בבקשת אצווה אחת (כמו יצירה ועדכון של אותו משלוח).
בדומה לכך, ייתכן שהתגובות שיתקבלו לבקשות מקובצות יוחזרו בסדר שונה מזה שברשומות הבקשות. אפשר להשתמש ב-BatchId כדי להתאים בין בקשות לתשובות, כי ייתכן שהתגובות מוחזרות מתוך רצף.
אפשר לשלוח בקשות אצווה ב-API על ידי קריאה ל-method 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."