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

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

مشاكل معدل نقل البيانات لطُرق 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 وتقديم ملاحظات إذا واجهت أي مشاكل أخرى.