تم إصدار طلب يستهدف حسابًا لا يمكن
للمستخدم الذي تمّت المصادقة عليه الوصول إليه.
الأسباب الشائعة
حدث خطأ في معرّف التاجر المستهدَف أو نسيت
تسجيل المستخدم في 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 وأنّ رمز
البلد هو رمز بلد صالح
وفقًا لمعيار 3166.
[item id] Invalid item
id: '<id>'
ملخّص
معرّف السلعة غير صالح، على سبيل المثال: sku123 بدلاً
من online:en:US:sku123
الأسباب الشائعة
تحديد معرّف عرض بدلاً من معرّف منتج
في طلب GET أو DELETE
نصائح حول كيفية التعامل مع الطلبات
غير متاح
نصائح للوقاية من الفيروس
تأكَّد من أنّ معرّف المنتج يتّبع التنسيق التالي:
channel:languageCode:countryCode:offerId.
حاولت تعديل سعر أحد
المنتجات على الإنترنت ومدى توفّره من خلال خلاصة المستودع، ولكن حدّدت قيمة أخرى غير
القيمة الخاصة online كمعرّف المتجر في عنوان URL.
الأسباب الشائعة
غير متاح
نصائح حول كيفية التعامل مع الطلبات
غيِّر رقم تعريف المتجر
إلى online في عنوان URL للطلب.
نصائح للوقاية من الفيروس
تأكَّد من تحديد online
للمنتجات على الإنترنت ورقم تعريف المتجر للمنتجات المتوفّرة داخل المتجر في كل طلبات البحث التي تجريها بشأن
المستودع.
العنصر الذي حاولت الحصول عليه أو تعديله أو حذفه ليس
موجودًا.
الأسباب الشائعة
محاولة حذف منتج غير
موجود أو عدم تحديد معرّف المنتج بشكل صحيح في عنوان 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.
الأسباب الشائعة
قد يتم إدراج المنتجات التي لا تجتاز عملية التحقّق، إذا لم تكن تحلّ محل منتج صالح حالي. ننصحك باستخدام علامة
includeInvalidInsertedItems لتحديد المنتجات التي يجب
Productstatuses.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 الصالحة فقط.
تأكَّد من تضمين
جميع السمات المقترَحة / المطلوبة لمنتجك. يُرجى الاطّلاع على مقالة "مركز المساعدة" الخاصة بمواصفات
الخلاصة للحصول على مزيد من المعلومات.
نصائح للوقاية من الفيروس
غير متاح
[link] validation/invalid_value for
<destinations>: URLs do not belong to your website
ملخّص
تم إرسال منتج يتضمّن عنوان URL أساسيًا يختلف
عن عنوان URL الذي طالب به حساب Merchant Center.
تاريخ التعديل الأخير: 2025-06-19 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2025-06-19 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This guide outlines common errors when using the Google Merchant API, categorized for easier understanding."],["Errors can relate to authentication, data conflicts, invalid data, missing information, or exceeding usage limits."],["Solutions include verifying user permissions, correcting product data, and adjusting request frequency."],["Refer to linked resources for detailed specifications, usage limits, and account management."],["This guide aids in troubleshooting and preventing common issues when interacting with the Google Merchant API."]]],["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"]]