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

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

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

تم الإبلاغ عنها في: ‎29/06/2026 بالتوقيت العالمي المنسّق (UTC)

نتلقّى تقارير عن ردود INTERNAL_ERROR المتقطّعة التي تؤثّر في طرق مختلفة من واجهة برمجة التطبيقات. عادةً ما يكون معدّل الخطأ% 0.1 تقريبًا، ولكنّه قد يكون أعلى قليلاً في بعض الأحيان.

نعمل حاليًا على حلّ هذه المشكلة. في الوقت الحالي، إذا ظهرت لك هذه الأخطاء، ننصحك بإعادة محاولة الطلب. إذا ظهرت لك معدّلات أخطاء عالية، يُرجى التواصل مع فريق الدعم.

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

تم الإبلاغ عنها في: ‎30/03/2026 بالتوقيت العالمي المنسّق (UTC) | تاريخ آخر تعديل: ‎17/04/2026 بالتوقيت العالمي المنسّق (UTC)

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

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

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

تم الإبلاغ عنها في: ‎18/03/2026 بالتوقيت العالمي المنسّق (UTC) | تاريخ آخر تعديل: ‎13/05/2026 بالتوقيت العالمي المنسّق (UTC)

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

إذا استمرّ ظهور وقت استجابة مرتفع، ننصحك بتقليل أحجام مجموعات الطلبات. إذا ظهرت لك رسائل الخطأ المذكورة أعلاه، يمكنك محاولة زيادة مهلات المهلة من جهة العميل.

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

تم الإبلاغ عنها في: ‎28/01/2026 بالتوقيت العالمي المنسّق (UTC) | تاريخ آخر تعديل: ‎31/03/2026 بالتوقيت العالمي المنسّق (UTC)

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

• accounts.productInputs.insert
• accounts.products.localInventories.insert
• accounts.products.regionalInventories.insert

أجرينا تحسينات لزيادة أداء أنظمة الخلفية المختلفة. إذا استمرّ ظهور هذه المشكلة، قد تحتاج إلى إعداد مجموعة قنوات لزيادة معدّل نقل البيانات إلى أقصى حدّ. يؤدي ذلك إلى تجاوز الحدّ الأقصى المعتاد لـ 100 بث لقناة gRPC واحدة من خلال إدارة عدّة عمليات ربط أساسية. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إعادة هيكلة الرمز البرمجي للطلبات المتزامنة: تحسين سرعة معالجة البيانات باستخدام مجموعات القنوات.

معرّفات المنتجات التي تتضمّن أحرفًا خاصة

تم الإبلاغ عنها في: ‎03/10/2025 بالتوقيت العالمي المنسّق (UTC) | تاريخ آخر تعديل: ‎08/04/2026 بالتوقيت العالمي المنسّق (UTC)

قد يواجه المستخدمون مشاكل عند إدارة المنتجات التي لا تتّبع فيها 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 بالتوقيت العالمي المنسّق (UTC) | تاريخ آخر تعديل: ‎12/05/2024 بالتوقيت العالمي المنسّق (UTC)

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

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

هل لديك أي مشكلة أخرى؟

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