وقت الاستجابة هو الوقت الذي يستغرقه تلقّي الردّ على طلب معيّن. يقدّم هذا الدليل معدّلات زمن الاستجابة لطلبات بيانات من واجهة برمجة التطبيقات Merchant API. استخدِم هذه القيم لضبط المهلات والتخطيط لمعدل نقل البيانات في عملية الدمج.
تكتمل معظم طلبات بيانات من واجهة برمجة التطبيقات Merchant API في أقل من ثانية. قد تستغرق تحديثات المستودع المحلي والإقليمي بضع ثوانٍ، وتستغرق بعض طلبات البحث في التقارير وقتًا أطول بكثير.
أوقات الاستجابة المعتادة
يسرد الجدول التالي فترات الاستجابة التقريبية حسب نوع الطلب. وقت الاستجابة المعتاد هو المتوسط: يكتمل نصف الطلبات بشكل أسرع. تستغرق أبطأ%1 من الطلبات المدة الموضّحة في العمود الأخير أو أكثر.
| نوع الطلب | أمثلة على الطرق | وقت الاستجابة المعتاد | أبطأ% 1 من الطلبات |
|---|---|---|---|
| عمليات القراءة والكتابة في المنتج | products.get، productInputs.insert، productInputs.patch، productInputs.delete |
من 100 إلى 600 ملي ثانية | دقيقتان تقريبًا |
| معظم الطلبات الأخرى | products.list، accounts.get، dataSources.list، aggregateProductStatuses.list |
أقل من ثانية واحدة | بضع ثوانٍ |
| عمليات كتابة المخزون المحلي والإقليمي | localInventories.insert وregionalInventories.insert وطُرق delete المقابلة |
بضع ثوانٍ | 10 ثوانٍ أو أكثر |
| طلبات البحث في التقارير | accounts.reports.search |
نصف ثانية تقريبًا | 30 ثانية أو أكثر |
تختلف طلبات البحث في التقارير بشكل كبير. ويعتمد وقت الاستجابة على جدول التقرير الذي تطلبه وعلى حجم البيانات التي يغطيها الطلب. يستغرق عادةً تنفيذ طلب واحد من بين كل 10 طلبات لإنشاء التقارير أكثر من ثانيتين، ويمكن أن يستغرق جزء صغير من الطلبات أكثر من دقيقة.
الاقتراحات
- اضبط مهلات مع توفير مساحة إضافية. إذا ضبطت مهلة الطلبات في برنامجك، اضبطها على قيمة أعلى بكثير من أبطأ وقت استجابة مدرج في أوقات الاستجابة المعتادة. على سبيل المثال، تترك مهلة 60 ثانية متسعًا كبيرًا لمعظم الطلبات، ولكن ليس لجميع طلبات البحث في التقارير.
- أرسِل طلبات مستقلة بالتوازي. بما أنّ عمليات كتابة المستودع تستغرق بضع ثوانٍ لكل عملية، فإنّ إرسالها واحدة تلو الأخرى يحدّ من معدّل النقل. أرسِل طلبات مستقلة بالتوازي أو استخدِم طلبات مجمّعة. عند إرسال طلبات متعددة، يُرجى الانتباه إلى الحدود القصوى في الدقيقة والحدود القصوى اليومية. لمزيد من المعلومات، يُرجى الاطّلاع على الحصص المحدّدة.
- احرص على حصر طلبات البحث في التقارير على البيانات التي تحتاج إليها. تستغرق طلبات البحث التي تغطي مجموعات بيانات كبيرة، مثل النطاقات الزمنية الطويلة، وقتًا أطول وقد تنتهي مهلتها. إذا كنت بحاجة إلى كميات كبيرة من البيانات، ننصحك باستخدام BigQuery. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تحميل بيانات Google Merchant Center إلى BigQuery.
- أعِد المحاولة باستخدام خوارزمية الرقود الأسي الثنائي. إذا انتهت مهلة الطلب أو تعذّر إكماله بسبب خطأ مؤقت، أعِد المحاولة باستخدام خوارزمية الرقود الأسي الثنائي.
وقت المعالجة
بالنسبة إلى الطلبات التي تغيّر البيانات، تعني الاستجابة الناجحة أنّ Merchant API قد قبلت التغيير، ولكن تستمر المعالجة بعد الاستجابة. وقت المعالجة هو الوقت من الاستجابة حتى يظهر التغيير في الموارد الأخرى. ولا يشمل وقت الاستجابة وقت المعالجة، ويمكن أن يكون أطول بكثير. على سبيل المثال، قد يستغرق الأمر بضع دقائق حتى يعكس المنتج الذي تمت معالجته بيانات المنتج التي تم إدخالها.
لمزيد من المعلومات حول الحالة النهائية التي تمت معالجتها لبياناتك، يُرجى الاطّلاع على الأدلة التالية: