توضّح هذه الصفحة المشاكل المعروفة التي يواجهها المطوّرون في Merchant API.
أخطاء عشوائية من نوع UnauthenticatedException
تم الإبلاغ عن المشكلة في: 30/03/2026 بالتوقيت العالمي المنسّق | تاريخ آخر تعديل: 17/04/2026 بالتوقيت العالمي المنسّق
يواجه عدّة عملاء أخطاء متقطّعة من نوع UnauthenticatedException عند تحميل المنتجات والوصول إلى واجهات برمجة تطبيقات Merchant Center الأخرى.
تحدث الأخطاء بشكلٍ عشوائي، حتى عند إعادة المحاولة، وتؤثر في كلّ من الطلبات الأولية والمحاولات اللاحقة. تفشل بعض عمليات الربط بينما تنجح عمليات أخرى في فترة قصيرة.
تم نشر إجراء للحدّ من المشكلة، ولا يزال البحث عن حلّ دائم مستمرًا. في حال ظهور هذا الخطأ، ننصحك بإعادة محاولة طلبات البيانات من واجهة برمجة التطبيقات.
زيادة وقت الاستجابة ورسالتَي الخطأ DEADLINE_EXCEEDED وINTERNAL_ERROR لطُرق المنتجات والمستودعات
تم الإبلاغ عن المشكلة في: 18/03/2026 بالتوقيت العالمي المنسّق | تم حلّها في: 31/03/2026 بالتوقيت العالمي المنسّق
واجه بعض المستخدمين وقت استجابة مستمرًا ورسالتَي الخطأ DEADLINE_EXCEEDED أو INTERNAL_ERROR بشكلٍ متكرّر عند استخدام طريقتَي productInputs وregionalInventories. تم تحديد السبب الرئيسي على أنّه حادث على مستوى الخلفية يؤثر في كفاءة المعالجة.
الحلّ: تم الحدّ من هذا الحادث بالكامل في 31/03/2026. بعد تخفيف الأثر، انخفضت معدّلات الخطأ بشكلٍ كبير. إذا استمرّ وقت الاستجابة مرتفعًا، ننصحك بالتحقّق من مهلات المهلة من جهة العميل وتقليل أحجام مجموعات الطلبات.
مشاكل معدّل نقل البيانات لطريقتَي insert للمنتجات والمستودعات
تم الإبلاغ عن المشكلة في: 28/01/2026 بالتوقيت العالمي المنسّق | تاريخ آخر تعديل: 31/03/2026 بالتوقيت العالمي المنسّق
تلقّينا تقارير عن مشاكل في الأداء من جهة العميل في ما يتعلّق بمعدّل نقل البيانات أثناء إرسال كميات كبيرة من البيانات إلى Merchant API. قد تظهر هذه المشكلة عند استخدام مكتبات العملاء للطريقتَين التاليتَين:
accounts.productInputs.insertaccounts.products.localInventories.insertaccounts.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 و تقديم ملاحظاتك للاطّلاع على أي مشاكل أخرى.