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

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

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

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

نتلقّى بلاغات عن حدوث أخطاء متقطّعة في الردود 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 الخاصة بالمنتجات والمستودعات

تاريخ الإبلاغ: ‎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 وإرسال ملاحظات في حال مواجهة أي مشاكل أخرى.