إصدار طلب يستهدف حسابًا لا يمكن للمستخدم الذي تمت المصادقة عليه الوصول إليه
الأسباب الشائعة
حدث خطأ في رقم تعريف التاجر المستهدَف أو لم يتم تسجيل المستخدم في Merchant Center.
نصائح مقترَحة للتعامل مع الأجهزة
تأكَّد من أنّك تستهدف الحساب الصحيح أو سجِّل نفسك كمستخدم للحساب في Merchant Center (الإعدادات > المستخدمون).
نصائح للوقاية من الفيروس
غير متاح
User is not an administrator of
account <account_number>
ملخّص
أرسل طلبًا لتعديل حساب لا يملك المستخدم الذي تمت المصادقة عليه أي أذونات مشرف له.
الأسباب الشائعة
غير متاح
نصائح مقترَحة للتعامل مع الأجهزة
ضبط حقوق المشرف للمستخدم الذي تمت مصادقته
نصائح للوقاية من الفيروس
غير متاح
تعارُض
[productId] Product ID <product
id> is already modified by another entry in the same request for merchant
<merchant> and store code <store code>
ملخّص
تمت محاولة تنفيذ عمليات متضاربة متعددة في الوقت نفسه.
الأسباب الشائعة
يحتوي طلب الدفعة الواحد على عمليات متضاربة متعددة للمنتج نفسه، أو تم إرسال عمليات متضاربة متعددة للمنتج نفسه إلى Content API في الوقت نفسه.
نصائح مقترَحة للتعامل مع الأجهزة
اطّلِع على نصائح الوقاية.
نصائح للوقاية من الفيروس
يجب أن تتضمّن جميع التغييرات الخاصة بمنتج معيّن في عملية واحدة ضمن مجموعة مجمّعة من الطلبات. حاوِل تجنُّب إجراء عدة طلبات متزامنة إلى Content API للمتجر ورمز التاجر نفسهما، أو تأكَّد من أنّ هذه الطلبات لا تتضمّن منتجات متداخلة.
internalError
Internal error
ملخّص
حدثت مشكلة في الخلفية البرمجية من Google.
الأسباب الشائعة
غير متاح
نصائح مقترَحة للتعامل مع الأجهزة
أعِد محاولة إرسال الطلب.
يُرجى التواصل معنا
إذا استمرّت المشكلة.
نصائح للوقاية من الفيروس
غير متاح
غير صالح
Invalid channel:
'<channel>'
ملخّص
تم تقديم قناة غير صالحة كجزء من معرّف المنتج.
على سبيل المثال: not_a_channel:en:US:sku123.
الأسباب الشائعة
غير متاح
نصائح مقترَحة للتعامل مع الأجهزة
غير متاح
نصائح للوقاية من الفيروس
تأكَّد من أنّ معرّف المنتج يتضمّن النموذج
channel:languageCode:countryCode:offerId، على سبيل المثال:
online:en:US:sku123. لمزيد من المعلومات، يُرجى الرجوع إلى المستندات المرجعية الخاصة بـ Products.insert.
[countrycode] Invalid country code:
'<country_code>'
ملخّص
تم تقديم رمز بلد غير صالح كجزء من معرّف المنتج.
على سبيل المثال: online:en:not_a_country_code:sku123.
الأسباب الشائعة
غير متاح
نصائح مقترَحة للتعامل مع الأجهزة
غير متاح
نصائح للوقاية من الفيروس
تأكَّد من أنّ معرّف المنتج يتضمّن channel:languageCode:countryCode:offerId وأنّ رمز البلد هو رمز بلد صالح
وفقًا لمعيار ISO 3166.
[item id] Invalid item
id: '<id>'
ملخّص
معرّف العنصر غير صالح، مثلاً sku123 بدلاً من online:en:US:sku123.
الأسباب الشائعة
تحديد معرّف عرض ترويجي بدلاً من معرّف منتج
في طلب GET أو DELETE
نصائح مقترَحة للتعامل مع الأجهزة
غير متاح
نصائح للوقاية من الفيروس
تأكَّد من أنّ معرّف المنتج يتّبع التنسيق
channel:languageCode:countryCode:offerId.
العنصر الذي حاولت الحصول عليه أو تعديله أو حذفه غير متوفّر.
الأسباب الشائعة
محاولة حذف منتج غير متوفّر أو عدم تحديد معرّف المنتج بشكل صحيح في عنوان URL الخاص بالحذف
نصائح مقترَحة للتعامل مع الأجهزة
احصل على قائمة بالمنتجات باستخدام Products.list وحاول فقط الحصول على العناصر التي تظهر فيها أو تعديلها أو حذفها. احرص على تحديد معرّف المنتج في النموذج
channel:languageCode:countryCode:offerId، على سبيل المثال:
online:ru:RU:277104-ekb بدلاً من معرّف العرض الذي يبدو
على النحو التالي: 277104-ekb.
نصائح للوقاية من الفيروس
غير متاح
not_inserted
The item could not be
inserted.
ملخّص
بسبب أخطاء أخرى، تعذّر إدراج المنتج
لأنّه سيؤدي إلى الكتابة فوق إدخال صالح حالي.
الأسباب الشائعة
غير متاح
نصائح مقترَحة للتعامل مع الأجهزة
راجِع الأخطاء الأخرى المتعلقة بالطلب نفسه، وحلّها قبل محاولة إعادة إدراج معلومات المنتج الجديدة.
نصائح للوقاية من الفيروس
غير متاح
الحصة
too_many_items: Merchant
quota exceeded
ملخّص
تم تحميل عدد كبير جدًا من السلع إلى Google Shopping.
الأسباب الشائعة
قد يتم إدراج المنتجات التي يتعذّر التحقّق من صحتها، إذا لم تحلّ محل منتج صالح حالي. ننصحك باستخدام العلامة includeInvalidInsertedItemsProductstatuses.list للتأكّد من أنّ حسابك لا يتضمّن عددًا كبيرًا من المنتجات غير الصالحة.
نصائح مقترَحة للتعامل مع الأجهزة
ابحث عن الأعداد المفرطة من المنتجات غير الصالحة وأزِلها كما هو موضّح أعلاه. بالإضافة إلى ذلك، حدِّد
تواريخ انتهاء الصلاحية عند تحميل المنتجات. وعندما يحين تاريخ انتهاء الصلاحية، يتم حذف المنتج تلقائيًا. يُرجى العِلم أنّ تاريخ انتهاء الصلاحية التلقائي والأقصى هو 30 يومًا بعد إدراج المنتج أو تعديله.
ملاحظة: يتم التحقّق من حصة السلع في الحساب المتعدّد العملاء من خلال مقارنتها بإجمالي عدد المنتجات في جميع الحسابات الفرعية. إذا ظهر لك هذا الخطأ مع حساب فرعي، تأكَّد من أنّ كلاً من الحساب الفرعي وحسابك المتعدّد العملاء لديهما حصة كافية من المنتجات.
request_rate_too_high:
Request rate too high. Please reduce your throughput
ملخّص
يتم حاليًا إجراء الكثير من الطلبات، لذا يُرجى تقليل معدّل تكرار الطلبات.
الأسباب الشائعة
يُرجى الرجوع إلى الحصص المحدّدة لكل دقيقة والمدرَجة في
الحدود المنشورة. إذا تجاوزت هذه الحدود، ستتلقّى رسالة الخطأ هذه. في بعض الأحيان، يحدث ارتفاع مفاجئ في عدد الزيارات يؤدي إلى حدوث ذلك، أو يتوسّع الخادم إلى عدد أكبر من سلاسل المحادثات.
نصائح مقترَحة للتعامل مع الأجهزة
قلِّل إجمالي عدد الطلبات
المرسَلة في الدقيقة.
نصائح للوقاية من الفيروس
عند تلقّي هذا الخطأ، استخدِم استراتيجيات التراجع الآلي لتقليل معدّل الطلبات إلى مستوى مناسب ومستدام.
daily_limit_exceeded:
merchant quota exceeded
ملخّص
أنت تجري عددًا من الطلبات يتجاوز الحدّ المسموح به يوميًا لطريقة الخدمة المحدّدة.
الأسباب الشائعة
يُرجى الرجوع إلى الحصص اليومية المُدرَجة في
الحدود المنشورة. إذا تجاوزت هذه الحدود، ستتلقّى رسالة الخطأ هذه.
نصائح مقترَحة للتعامل مع الأجهزة
يمكنك تقليل إجمالي عدد الطلبات المرسَلة يوميًا من خلال دمج عدة تغييرات في طلب واحد، وذلك عند الإمكان. ننصحك بتجميع التغييرات على المنتجات على مدار فترة زمنية مناسبة لتجنُّب تغيير المنتج عدة مرات بسرعة. بالنسبة إلى تعديلات المنتجات التي يمكن تمثيلها كـ بيانات جزئية على موقعك الإلكتروني، ننصحك باستخدام هذه الطريقة للحدّ من عدد الطلبات التي يتم إرسالها إلى خدمات Products أو Inventory.
إذا كنت لا تزال بحاجة إلى المزيد من طلبات البيانات اليومية لطريقة معيّنة، يُرجى التواصل معنا وإعلامنا بمعرّف حسابك على Merchant Center والطرق التي بلغت فيها حدود الحصة وعدد الطلبات المقدّر التي ستحتاج إليها يوميًا لهذه الطرق وسبب ذلك، وسنعمل معك لزيادة حصتك.
نصائح للوقاية من الفيروس
اطّلِع على نصائح حول التعامل مع المواد الكيميائية.
too_many_failed_auths:
Too many failed authentications.
ملخّص
أنت ترسل عددًا كبيرًا جدًا من طلبات الدفعات لحسابات ليس لديك إذن الوصول إليها.
الأسباب الشائعة
تقديم طلبات بشكل مجمّع للحسابات الفرعية التي تم حذفها أو للحسابات الفرعية التي تم إنشاؤها حديثًا قبل أن تصبح متاحة
نصائح مقترَحة للتعامل مع الأجهزة
تجنَّب إجراء طلبات تؤثّر في حساب فرعي محذوف.
نصائح للوقاية من الفيروس
اطّلِع على نصائح حول التعامل مع المواد الكيميائية.
request_too_large
ملخّص
أنّك ترسل عددًا كبيرًا جدًا من entries لكل طلب مجمّع، أو أنّك تتجاوز الحدّ الأقصى لحجم الطلب custombatch.
الأسباب الشائعة
يمكنك تضمين 10,000 entries كحد أقصى لكل طلب custombatch، والحد الأقصى لحجم النقل المضغوط هو 32 ميغابايت.
نصائح مقترَحة للتعامل مع الأجهزة
قسِّم الدفعة إلى دفعات متعددة أقل من الحدود المسموح بها، ثم أعِد المحاولة.
نصائح للوقاية من الفيروس
ننصحك بعدم إرسال أكثر من 1,000 إدخال لكل مجموعة.
مطلوب
[price.value] Required parameter: price.value
ملخّص
تم تحديد سعر بدون قيمة. على سبيل المثال:
{ "currency": "USD" } بدلاً من
{ "value": 123, "currency": "USD" }.
الأسباب الشائعة
غير متاح
نصائح مقترَحة للتعامل مع الأجهزة
تأكَّد من أنّ المَعلمة، وهي price في هذا المثال، منسَّقة بشكل صحيح. على سبيل المثال، تحتوي price على حقلَين إلزاميَّين: value وcurrency.
نصائح للوقاية من الفيروس
غير متاح
[product] INSERT request must specify
product
ملخّص
أرسلت طلبًا مجمّعًا مخصّصًا إلى واجهة برمجة التطبيقات
يتضمّن إدخالاً مع "method": "insert" ولكن بدون منتج.
الأسباب الشائعة
عدم تغيير الطريقة إلى get
أو delete
نصائح مقترَحة للتعامل مع الأجهزة
حدِّد منتجًا لإدراجه من خلال الحقل product.
نصائح للوقاية من الفيروس
تأكَّد من أنّ إدخالات الدُفعات التي تتضمّن الطريقة
insert تحدّد منتجًا، وأنّ إدخالات الدُفعات التي تتضمّن الطريقة
get أو delete تحدّد معرّف منتج.
[productId] DELETE request must specify
productId
ملخّص
أرسلت طلبًا مجمّعًا مخصّصًا إلى واجهة برمجة التطبيقات
يتضمّن إدخالاً يحتوي على "method": "delete" ولكن بدون معرّف
منتج.
الأسباب الشائعة
عدم تغيير طريقة الدفع إلى
insert
نصائح مقترَحة للتعامل مع الأجهزة
حدِّد منتجًا
لحذفه من خلال الحقل productID.
نصائح للوقاية من الفيروس
تأكَّد من أنّ إدخالات الدُفعات التي تتضمّن الطريقة
insert تحدّد منتجًا، وأنّ إدخالات الدُفعات التي تتضمّن الطريقة
get أو delete تحدّد معرّف منتج.
userRateLimitExceeded
User Rate Limit
Exceeded
ملخّص
يتم حاليًا إجراء الكثير من الطلبات، لذا يُرجى تقليل معدّل تكرار الطلبات.
الأسباب الشائعة
يُرجى الرجوع إلى الحدود القصوى لطلبات HTTP الواردة في
الحدود القصوى المنشورة. إذا تجاوزت هذه الحدود، ستتلقّى رسالة الخطأ هذه. في بعض الأحيان، تحدث زيادة مفاجئة في عدد الزيارات تؤدي إلى ذلك، أو يتوسّع الخادم ليشمل عددًا أكبر من سلاسل المحادثات.
نصائح مقترَحة للتعامل مع الأجهزة
قلِّل إجمالي عدد الطلبات
المرسَلة في الدقيقة. سيؤدي تجميع طلبات متعددة إلى الخدمة نفسها في طلب custombatch واحد إلى تقليل عدد طلبات HTTP التي يتم إجراؤها.
نصائح للوقاية من الفيروس
عند تلقّي هذا الخطأ، استخدِم استراتيجيات التجميع والتراجع الآلي لتقليل معدّل الطلبات إلى مستوى مناسب ومستدام.
الإثبات
[adwords_redirect]
ملخّص
أرسلت منتجًا حقل adwords_redirect الخاص به ليس عنوان URL صالحًا.
إرسال علامة تجارية أو وصف أو سمة أخرى
كسلسلة لا يمكن تحليلها باستخدام ترميز الطلب المحدّد
الأسباب الشائعة
غير متاح
نصائح مقترَحة للتعامل مع الأجهزة
راجِع الرسالة لمعرفة السمة التي تسبّب المشكلة، ثم تحقّق من ترميز النص للقيمة المقابلة قبل إعادة الإرسال. لا تقبل واجهة برمجة التطبيقات سوى أحرف UTF-8 صالحة.
تاريخ التعديل الأخير: 2026-07-06 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2026-07-06 (حسب التوقيت العالمي المتفَّق عليه)"],[],["The document details errors within the Merchant API, which is the future version of the Content API for Shopping. Key errors involve `notFound` (item does not exist), `not_inserted` (cannot insert due to conflicts), and `quota/too_many_items` (exceeded upload limits). Handling involves verifying product IDs, addressing conflicting entries, and managing quotas. Common causes include incorrect IDs, simultaneous conflicting operations, and exceeding item limits. Prevention focuses on formatting product IDs correctly, batching changes, reducing invalid products, and using product expiration dates. Other errors such as account access, internal issues, URL, currency, ID, and missing parameters are covered.\n"]]
