با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
custombatch یک روش رایج است که به شما امکان می دهد چندین تماس API را که به عنوان "ورودی" شناخته می شوند در یک درخواست HTTP گروه بندی کنید. هر ورودی فقط به یک فراخوانی متد اشاره دارد.
دسته سفارشی انتخاب خوبی است زمانی که:
شما به تازگی استفاده از API را شروع کرده اید و داده های محصول زیادی برای آپلود دارید.
شما باید داده های محلی را با ارسال تعداد زیادی به روز رسانی و حذف با سرور همگام سازی کنید.
درخواست های دسته ای ارائه دهید
ارسال درخواست های دسته ای مشابه ارسال تماس های API به صورت موازی است. توجه داشته باشید که هیچ تضمینی وجود ندارد که ترتیب ورودی های تعریف شده در درخواست به ترتیبی باشد که اجرا می شوند. توصیه می‌کنیم از تماس‌های وابسته به هم در یک درخواست دسته‌ای استفاده نکنید (مانند ایجاد و به‌روزرسانی یک محموله).
به طور مشابه، پاسخ‌های دریافت شده برای درخواست‌های دسته‌ای ممکن است به ترتیبی متفاوت از ورودی‌های درخواست بازگردانده شوند. BatchId را می توان برای ارتباط بین درخواست ها و پاسخ ها استفاده کرد زیرا ممکن است پاسخ ها خارج از ترتیب بازگردانده شوند.
می‌توانید با فراخوانی روش custombatch مناسب، درخواست‌های دسته‌ای را در API انجام دهید:
برای جلوگیری از خطا هنگام آپلود دسته‌های بزرگ، توصیه می‌کنیم اندازه درخواست‌های custombatch را به حداکثر 1000 ورودی محدود کنید. حداکثرهای زیر برای درخواست های custombatch اعمال می شود:
50000 ورودی در هر درخواست 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"]]
