تأخیر مدت زمانی است که طول می‌کشد تا پاسخ درخواست را دریافت کنید. این راهنما زمان‌های تأخیر حدودی را برای درخواست‌های Merchant API ارائه می‌دهد. از این مقادیر برای تنظیم زمان‌های اتمام مهلت و برنامه‌ریزی توان عملیاتی ادغام خود استفاده کنید.
اکثر درخواست‌های Merchant API در کمتر از یک ثانیه تکمیل می‌شوند. به‌روزرسانی‌های موجودی محلی و منطقه‌ای ممکن است چند ثانیه طول بکشد و برخی‌از پُرسمان‌های گزارش بسیار بیشتر طول می‌کشد.
تأخیرهای معمول
جدول زیر تأخیرهای تقریبی را براساس نوع درخواست فهرست می‌کند. تأخیر معمولی عبارت است از میانه: نیمی از درخواست‌ها سریع‌تر تکمیل می‌شوند. کندترین ۱٪ درخواست‌ها به‌اندازه مدت‌زمان نشان‌داده‌شده در ستون آخر یا بیشتر طول می‌کشد.
| نوع درخواست | روش‌های نمونه | تأخیر معمول | ٪۱ از آهسته‌ترین درخواست‌ها |
|---|---|---|---|
| محصول می‌خواند و می‌نویسد | products.get، productInputs.insert، productInputs.patch، productInputs.delete |
۱۰۰ تا ۶۰۰ میلی‌ثانیه | حدود ۲ ثانیه |
| بیشتر درخواست‌های دیگر | products.list، accounts.get، dataSources.list، aggregateProductStatuses.list |
کمتر از ۱ ثانیه | چند ثانیه |
| نوشتن فهرست موجودی محلی و منطقه‌ای | localInventories.insert، regionalInventories.insert، و روش‌های delete مربوطه |
چند ثانیه | ۱۰ ثانیه یا بیشتر |
| گزارش کردن پرسمان‌ها | accounts.reports.search |
حدود نیم ثانیه | ۳۰ ثانیه یا بیشتر |
پرسمان‌های گزارش بیشترین تنوع را دارند. تأخیر آن‌ها به جدول گزارشی که پُرسمان می‌کنید و به مقدار داده‌ای که پُرسمان پوشش می‌دهد بستگی دارد. معمولاً حدود ۱ پرس‌وجوی گزارش از هر ۱۰ پرس‌وجو بیشتر از ۲ ثانیه طول می‌کشد و بخش کوچکی از آن‌ها ممکن است بیشتر از یک دقیقه طول بکشد.
توصیه‌ها
- زمان‌های اتمام مهلت را با فضای خالی تنظیم کنید. اگر در کارخواهتان زمان اتمام درخواست تنظیم کرده‌اید، آن‌ها را بسیار بالاتر از کندترین تأخیرهای فهرست‌شده در تأخیرهای معمول تنظیم کنید. برای مثال، مهلت ۶۰ ثانیه‌ای برای اکثر درخواست‌ها کافی است، اما برای همه پُرسمان‌های گزارش کافی نیست.
- درخواست‌های مستقل را به‌طور موازی ارسال کنید. چون نوشتن موجودی هرکدام چند ثانیه طول می‌کشد، ارسال آن‌ها یکی پس‌از دیگری توان عملیاتی شما را محدود می‌کند. درخواست‌های مستقل را به‌صورت موازی ارسال کنید یا از درخواست‌های دسته‌ای استفاده کنید. هنگام ارسال چندین درخواست، به حد مجاز دقیقه‌ای و حد مجاز روزانه خود توجه کنید. برای اطلاعات بیشتر، سهمیه‌های نرخ را ببینید.
- پُرسمان‌های گزارش را به داده‌هایی که نیاز دارید محدود کنید. عبارت‌های جستجویی که مجموعه داده‌های بزرگ را پوشش می‌دهند، مثل محدوده‌های تاریخ طولانی، بیشتر طول می‌کشند و ممکن است مهلتشان تمام شود. اگر به حجم زیادی از داده‌ها نیاز دارید، استفاده از BigQuery را درنظر بگیرید. برای اطلاعات بیشتر، بار کردن داده‌های Google Merchant Center در BigQuery را ببینید.
- با عقب‌گرد نمایی دوباره امتحان کنید. اگر درخواست به‌دلیل خطای گذرا با وقفه زمانی مواجه شد یا ناموفق بود، آن را با عقب‌نشینی نمایی دوباره امتحان کنید.
زمان پردازش
برای درخواست‌هایی که داده‌ها را تغییر می‌دهند، پاسخ موفقیت‌آمیز به این معنی است که Merchant API تغییر را پذیرفته است، اما پردازش پس‌از پاسخ ادامه می‌یابد. زمان پردازش مدت زمانی است که از پاسخ تا نمایان شدن تغییر در منابع دیگر طول می‌کشد. زمان پردازش بخشی از تأخیر نیست و می‌تواند بسیار طولانی‌تر باشد. برای مثال، ممکن است چند دقیقه طول بکشد تا محصول پردازش‌شده ورودی محصول درج‌شده را منعکس کند.
برای کسب اطلاعات بیشتر درباره وضعیت پردازش نهایی داده‌هایتان، راهنماهای زیر را ببینید: