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

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

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

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

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

لم يتم التوصّل إلى حل بديل أو اقتراحات حتى الآن.

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

تاريخ الإبلاغ: 2026-03-18 بالتوقيت العالمي المتفق عليه | تاريخ الحل: 2026-03-31 بالتوقيت العالمي المتفق عليه

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

الحل: تم تخفيف حدة هذه المشكلة بالكامل في 31 آذار (مارس) 2026. بعد تنفيذ إجراءات التخفيف، انخفضت معدّلات الخطأ بشكلٍ كبير. إذا استمرّت مواجهة مشاكل في وقت الاستجابة، ننصحك بالتحقّق من مهلات من جهة العميل وتقليل أحجام مجموعات الطلبات.

مشاكل معدل نقل البيانات لطُرق insert الخاصة بالمنتجات والمستودعات

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

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

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