توضّح هذه الصفحة المشاكل المعروفة التي يواجهها المطوّرون عند استخدام Merchant API.
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.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 وتقديم ملاحظات إذا واجهت أي مشاكل أخرى.