المشاكل المعروفة

توضّح هذه الصفحة المشاكل المعروفة التي يواجهها المطوّرون مع Merchant API.

ردود INTERNAL_ERROR المتقطّعة

تم الإبلاغ عنها في: ‎29/06/2026 بالتوقيت العالمي المنسّق

نتلقّى تقارير عن ردود INTERNAL_ERROR المتقطّعة التي تؤثّر في طرق مختلفة من واجهة برمجة التطبيقات. عادةً ما يكون معدّل الخطأ حوالي% 0.1، ولكنّه قد يكون أعلى قليلاً في بعض الأحيان.

نعمل حاليًا على حلّ هذه المشكلة. في الوقت الحالي، إذا ظهرت لك هذه الأخطاء، ننصحك بإعادة محاولة الطلب. إذا ظهرت لك معدّلات أخطاء عالية، يُرجى التواصل مع فريق الدعم.

أخطاء عشوائية في UnauthenticatedException

تم الإبلاغ عنها في: ‎30/03/2026 بالتوقيت العالمي المنسّق | آخر تعديل: ‎17/04/2026 بالتوقيت العالمي المنسّق

يواجه عدّة عملاء أخطاء UnauthenticatedException المتقطّعة عند تحميل المنتجات والوصول إلى واجهات برمجة تطبيقات Merchant Center الأخرى. تحدث الأخطاء بشكلٍ عشوائي، حتى عند إعادة المحاولة، وتؤثّر في كلٍّ من الطلبات الأولية والمحاولات اللاحقة. تفشل بعض عمليات الربط بينما تنجح عمليات أخرى في فترة قصيرة.

تم نشر إجراء للتخفيف من هذه المشكلة، ولا يزال التحقيق جارٍ للوصول إلى حلّ دائم. إذا ظهر لك هذا الخطأ، ننصحك بإعادة محاولة طلبات البيانات من واجهة برمجة التطبيقات.

زيادة وقت الاستجابة ورسالتا الخطأ DEADLINE_EXCEEDED وINTERNAL_ERROR لطرق المنتجات والمستودعات

تم الإبلاغ عنها في: ‎18/03/2026 بالتوقيت العالمي المنسّق | آخر تعديل: ‎13/05/2026 بالتوقيت العالمي المنسّق

واجه بعض المستخدمين وقت استجابة مستمرًا ورسالتي الخطأ DEADLINE_EXCEEDED أو INTERNAL_ERROR بشكلٍ متكرّر عند استخدام طريقتَي productInputs وregionalInventories. تم تحديد السبب الرئيسي على أنّه حادث على مستوى النظام الخلفي يؤثّر في كفاءة المعالجة. لا تزال الجهود جارية لحلّ هذه المشكلة.

إذا استمرّ ظهور وقت استجابة مرتفع، ننصحك بتقليل أحجام مجموعات الطلبات. إذا ظهرت لك رسالتا الخطأ المذكورتان أعلاه، يمكنك محاولة زيادة مهلات المهلة على جانب العميل.

مشاكل معدّل النقل لطريقتَي insert للمنتجات والمستودعات

تم الإبلاغ عنها في: ‎28/01/2026 بالتوقيت العالمي المنسّق | آخر تعديل: ‎31/03/2026 بالتوقيت العالمي المنسّق

تلقّينا تقارير عن مشاكل في الأداء على جانب العميل في معدّل النقل أثناء إرسال كميات كبيرة من البيانات إلى Merchant API. قد تظهر لك هذه المشكلة عند استخدام مكتبات العملاء للطريقتَين التاليتَين:

• accounts.productInputs.insert
• accounts.products.localInventories.insert
• accounts.products.regionalInventories.insert

أجرينا تحسينات لزيادة أداء الأنظمة الخلفية المختلفة. إذا استمرّ ظهور هذه المشكلة، قد تحتاج إلى إعداد مجموعة قنوات لزيادة معدّل النقل إلى أقصى حدّ. يؤدي ذلك إلى تجاوز الحدّ الأقصى المعتاد وهو 100 بث لقناة gRPC واحدة من خلال إدارة عدّة اتصالات أساسية. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إعادة تصميم الرمز البرمجي للطلبات المتزامنة: تحسين معدّل النقل باستخدام مجموعات القنوات.

معرّفات المنتجات التي تتضمّن أحرفًا خاصة

تم الإبلاغ عنها في: ‎03/10/2025 بالتوقيت العالمي المنسّق | آخر تعديل: ‎08/04/2026 بالتوقيت العالمي المنسّق

قد يواجه المستخدمون مشاكل عند إدارة المنتجات التي لا تتّبع فيها productId أو offerId إرشادات تنسيق معرّف المنتج. قد تحتوي معرّفات المنتجات هذه على أحرف خاصة، وأبرزها الشرطات المائلة (/) والنقطتان الرأسيتان (:) والمدّات (~) وعلامات النسبة المئوية (%). تسمح بعض المنصّات، مثل Merchant Center، ببعض الأحرف الخاصة في معرّفات المنتجات.

بما أنّ Merchant API يدمج معرّف المنتج مباشرةً في name المورد كجزء من عنوان URL (مثل accounts/{account}/products/{productId})، يمكن أن تتداخل هذه الأحرف مع التوجيه والتحليل العاديَين لعنوان URL، ما يؤدي إلى ظهور أخطاء غير متوقّعة مثل 404 Not Found أو 400 Bad Request أثناء عمليات GET أو PATCH أو DELETE.

للتفاعل بأمان مع المنتجات التي تحتوي على هذه الأحرف، عليك ترميز جزء productId أو offerId من اسم المورد. خوارزمية الترميز هي ترميز Base64URL بدون مساحة إضافية. لمزيد من المعلومات، يُرجى الاطّلاع على accounts.productInputs.name.

تم حلّ المشكلة: لقد طرحنا حلاً لتوحيد السلوك في جميع أنحاء نظام Merchant API. أضفنا حقلًا جديدًا base64_encoded_name إلى ردود واجهة برمجة التطبيقات يوفّر اسم المورد الذي تم ترميزه مسبقًا، ما يسمح لك باستخدام ناتج طلب قائمة أو طلب الحصول على البيانات مباشرةً كإدخال للتعديلات اللاحقة بدون إجراء الترميز يدويًا.

التأخير بعد إنشاء مصدر البيانات

تم الإبلاغ عنها في: ‎10/04/2024 بالتوقيت العالمي المنسّق | آخر تعديل: ‎12/05/2024 بالتوقيت العالمي المنسّق

حدث تأخير معروف عند محاولة إدراج المنتجات أو العروض الترويجية أو المراجعات مباشرةً بعد إنشاء DataSource جديد. ظهر الخطأ Data source not found عند محاولة إدراج السلع في غضون 5 دقائق من إنشاء مصدر البيانات.

تم حلّ المشكلة: تم التخلّص من هذا التأخير، ما يسمح بالتفاعل بشكلٍ فوري أكثر مع مصادر البيانات التي تم إنشاؤها حديثًا.

هل لديك أي مشكلة أخرى؟

يُرجى الانتقال إلى صفحتَي الحصول على مساعدة بشأن Merchant API و تقديم ملاحظات لأي مشاكل أخرى.