تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
custombatch هي طريقة شائعة تتيح لك تجميع عدة طلبات للحصول على البيانات من واجهة برمجة التطبيقات، ويُشار إليها باسم "الإدخالات"، في طلب HTTP واحد. يشير كل إدخال إلى دعوة
طريقة واحدة فقط.
يكون "الدفع المجمّع المخصّص" خيارًا جيدًا في الحالات التالية:
إذا كنت قد بدأت للتو في استخدام واجهة برمجة التطبيقات ولديك الكثير من بيانات المنتجات المطلوب تحميلها
يجب مزامنة البيانات المخزّنة على الجهاز مع الخادم من خلال إرسال الكثير من عمليات
التعديل والحذف.
تقديم طلبات مجمّعة
يشبه إرسال الطلبات المجمّعة إرسال طلبات واجهة برمجة التطبيقات بالتوازي. يُرجى العِلم أنّه
لا يمكن ضمان أنّ ترتيب الإدخالات المحدّد في الطلب
سيكون بالترتيب الذي يتم تنفيذه به. ننصحك بعدم استخدام
طلبات مترابطة في طلب دفعة واحد (مثل إنشاءshipment نفسه وتعديله).
وبالمثل، قد يتم عرض الردود التي تم استلامها للطلبات المجمّعة بترتيب مختلف عن ترتيب إدخالات الطلبات. يمكن استخدام BatchId لمحاولة
ربط الطلبات والردود، لأنّه قد يتم عرض الردود بدون ترتيب.
يمكنك تجميع الطلبات في واجهة برمجة التطبيقات من خلال استدعاء 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."
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The Merchant API is the new version of the Content API for Shopping and is now in beta."],["Use the `custombatch` method to group several API calls into a single HTTP request for efficiency, especially for initial data uploads and synchronization."],["Batch requests have a limit of 50,000 entries and 32Mb transfer size; exceeding these limits will result in errors."],["There's no guarantee that batched requests will be executed or returned in the order they were defined; use `BatchId` to correlate requests and responses."],["For more details and to learn how the Merchant API can improve your integration, visit the announcement blog post."]]],["The Merchant API beta, a new version of the Content API for Shopping, is introduced. It uses `custombatch`, a method to group multiple API calls into a single HTTP request for efficient data uploading and synchronization. `Custombatch` suits large data transfers but doesn't guarantee execution order. `BatchId` correlates requests and responses. Batches can have top-level or entry-specific errors. There is a recommended limit of 1,000 entries per batch with maximum limits of 50,000 entries, and 32Mb size.\n"]]
