custombatch هي طريقة شائعة تتيح لك تجميع عدة طلبات بيانات من واجهة برمجة التطبيقات، المعروفة باسم "الإدخالات" في طلب HTTP واحد. يشير كل إدخال فقط
إلى استدعاء طريقة واحدة.
تكون الدفعة المخصّصة خيارًا جيدًا في الحالات التالية:
- لقد بدأت للتو في استخدام واجهة برمجة التطبيقات ولديك الكثير من بيانات المنتجات لتحميلها.
- تحتاج إلى مزامنة البيانات المحلية مع الخادم عن طريق إرسال الكثير من التحديثات والحذف.
تقديم طلبات مجمّعة
يشبه إرسال الطلبات المجمّعة إرسال طلبات البيانات من واجهة برمجة التطبيقات بالتوازي. لاحظ أنه لا يوجد ضمان أن يكون ترتيب الإدخالات المحددة في الطلب بالترتيب الذي يتم تنفيذه بها. ننصح بعدم استخدام الاتصالات المترابطة في طلب مجمّع واحد (مثل إنشاء نفس الشحنة وتحديثها).
وبالمثل، قد يتم عرض الردود الواردة على الطلبات المجمّعة بترتيب مختلف عن إدخالات الطلبات. ويمكن استخدام BatchId لربط الطلبات والردود، لأنّ الردود قد يتم عرضها بترتيب متتابع.
يمكنك تجميع الطلبات في واجهة برمجة التطبيقات عن طريق استدعاء طريقة 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 ميغابايت
تؤدي المكالمات التي تتجاوز الحد الأقصى إلى أخطاء request_too_large التالية:
"Too many requests in a batch.""Request payload size exceeds the limit: %d bytes."