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

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

زيادة وقت الاستجابة

تاريخ الإبلاغ: 2026-06-09 بالتوقيت العالمي المتفق عليه

يواجه العديد من العملاء أخطاء وزيادة في وقت الاستجابة عند الوصول إلى طرق مختلفة في Merchant Center API.

يجري حاليًا تحقيق في السبب الأساسي للمشكلة.

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 الخاصة بالمنتجات والمستودعات

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

تلقّينا بلاغات عن مشاكل في الأداء من جهة العميل بشأن معدل نقل البيانات أثناء إرسال كميات كبيرة من البيانات إلى 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 إلى ردود واجهة برمجة التطبيقات الذي يوفّر اسم المورد الذي تم ترميزه مسبقًا، ما يتيح لك استخدام ناتج قائمة أو طلب get مباشرةً كإدخال للتعديلات اللاحقة بدون إجراء الترميز يدويًا.

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

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

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

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

هل تواجه أي مشكلة أخرى؟

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