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

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

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

تاريخ الإبلاغ: 28 يناير 2026 بالتوقيت العالمي المنسَّق | تاريخ آخر تعديل: 31 مارس 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 وتقديم الملاحظات لأي مشاكل أخرى.