في ما يلي الأخطاء الأكثر شيوعًا:
notFound: لم يتم العثور على العنصر.not_inserted: تعذّر إدراج السلعة.[link] validation/invalid_value for <destinations>: لا تنتمي عناوين URL إلى موقعك الإلكتروني.- quota/too_many_items: تم تجاوز حصة التاجر.
في ما يلي قائمة بالأخطاء بالترتيب الأبجدي.
auth/account_access_denied/
User cannot access account
<account_number> |
|
|---|---|
| ملخّص | تم إصدار طلب يستهدف حسابًا لا يملك المستخدم الذي تمت مصادقته الدخول إليه. |
| الأسباب الشائعة | حدث خطأ في معرّف التاجر المستهدف أو نسيت تسجيل المستخدم في 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. |
[name] The term '<term>' is not
allowed |
|
| ملخّص | يحتوي الاسم على كلمة محظورة. |
| الأسباب الشائعة | غير متاح |
| نصائح مقترَحة للتعامل مع الصور | استخدِم اسمًا مسموحًا به. راجِع مقالة "مركز المساعدة" لمواصفات الخلاصة للاطّلاع على مزيد من المعلومات. |
| نصائح للوقاية من الفيروس | غير متاح |
[price.currency] Please use a currency
that is supported in the target country |
|
| ملخّص | تم تحديد عملة غير متوفرة في البلد المستهدف. |
| الأسباب الشائعة | غير متاح |
| نصائح مقترَحة للتعامل مع الصور | تأكَّد من تحديد العملة والبلد بشكل صحيح. للاطّلاع على مزيد من المعلومات، يمكنك مراجعة القسم بشأن price في مقالة مركز المساعدة حول مواصفات الخلاصة. |
| نصائح للوقاية من الفيروس | غير متاح |
[storeCode] storeCode must be
'online' |
|
| ملخّص | حاولنا تعديل سعر منتج على الإنترنت ومدى توفّره
من خلال خلاصة المستودع، ولكنّنا حدّدنا قيمة أخرى غير
القيمة الخاصة online كرقم تعريف المتجر في عنوان URL. |
| الأسباب الشائعة | غير متاح |
| نصائح مقترَحة للتعامل مع الصور | غيِّر رقم تعريف المتجر
إلى online في عنوان URL للطلب. |
| نصائح للوقاية من الفيروس | احرص على تحديد online
للمنتجات على الإنترنت ومعرّف المتجر للمنتجات المحلية في كل
طلبات البحث عن المستودع. |
[<attribute>] |
|
| ملخّص | العنصر المحدد في الأقواس المربعة غير صالح. |
| الأسباب الشائعة | غير متاح |
| نصائح مقترَحة للتعامل مع الصور | أصلِح مواصفات العنصر الذي تظهر فيه المشكلة، ويمكنك الرجوع إلى مقالة "مركز المساعدة" حول مواصفات الخلاصة للحصول على مزيد من المعلومات. |
| نصائح للوقاية من الفيروس | غير متاح |
notFound
Item not found |
|
|---|---|
| ملخّص | العنصر الذي حاولت الحصول عليه أو تعديله أو حذفه غير متوفّر. |
| الأسباب الشائعة | محاولة حذف منتج غير متوفّر أو عدم تحديد معرّف المنتج بشكل صحيح في عنوان 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 يومًا بعد إدراج المنتج أو تعديله. ملاحظة: يتم التحقّق من حصة السلع لحساب متعدّد العملاء مقابل إجمالي عدد المنتجات في كل الحسابات الفرعية. إذا ظهر لك هذا الخطأ في حساب فرعي، تأكَّد من توفّر حصة منتج كافية في كلّ من الحساب الفرعي وحساب الحساب المتعدّد العملاء. إذا جربت هذه الحلول ولا تزال المساحة المتوفرة للمنتجات الجديدة على وشك النفاد في حسابك على Merchant Center، يمكنك طلب إمكانية إرسال المزيد من السلع في حسابك. |
| نصائح للوقاية من الفيروس | يمكنك الاطّلاع على نصائح حول المناولة المقترَحة. |
too_many_subaccounts:
Maximum number of subaccounts reached |
|
| ملخّص | لقد بلغت الحد الأقصى لعدد الحسابات الفرعية المسموح بها لحسابك المتعدّد العملاء. |
| الأسباب الشائعة | غير متاح |
| نصائح مقترَحة للتعامل مع الصور | احذف الحسابات الفرعية القديمة. إذا كانت جميع حساباتك نشطة، يمكنك طلب إمكانية إنشاء حسابات فرعية إضافية في حسابك المتعدّد العملاء. |
| نصائح للوقاية من الفيروس | غير متاح |
request_rate_too_high:
Request rate too high. Please reduce your throughput |
|
| ملخّص | يتم تقديم الطلبات بسرعة كبيرة جدًا، لذلك ننصحك بتقليل معدّل تكرار الطلب. |
| الأسباب الشائعة | يمكنك الرجوع إلى الحصص في الدقيقة والمدرَجة في الحدود المنشورة. وفي حال تجاوز هذه المعايير، سيظهر لك هذا الخطأ. ويؤدي ذلك أحيانًا إلى ارتفاع في عدد الزيارات، أو قد يوسّع الخادم لديك إلى عدد أكبر من سلاسل المحادثات. |
| نصائح مقترَحة للتعامل مع الصور | قلِّل إجمالي عدد الطلبات المرسَلة في الدقيقة. |
| نصائح للوقاية من الفيروس | عند ظهور هذا الخطأ، استخدِم استراتيجيات التراجع الآلي لخفض معدّل الطلبات إلى مستوى مستدام مناسب. |
daily_limit_exceeded:
merchant quota exceeded |
|
| ملخّص | أنت ترسل أكثر من العدد المسموح به من الطلبات في اليوم لطريقة الخدمة المحددة. |
| الأسباب الشائعة | راجِع الحصص اليومية المدرَجة في الحدود المنشورة. وفي حال تجاوز هذه المعايير، سيظهر لك هذا الخطأ. |
| نصائح مقترَحة للتعامل مع الصور | قلِّل إجمالي
الطلبات المُرسَلة في اليوم من خلال دمج تغييرات متعددة في طلب واحد
عند الإمكان. يمكنك تجميع التغييرات على المنتجات خلال فترة زمنية مناسبة لتجنّب تغيير المنتج بسرعة عدة مرات. بالنسبة إلى تعديلات السلع التي يمكن تمثيلها على شكل بيانات جزئية على موقعك الإلكتروني، ننصحك باستخدام هذا النهج للحدّ من عدد المكالمات إلى خدمتَي إذا كنت لا تزال بحاجة إلى إجراء المزيد من المكالمات اليومية باستخدام طريقة معيّنة، يُرجى التواصل معنا وإعلامنا بمعرّف 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 صالحًا. |
| الأسباب الشائعة | غير متاح |
| نصائح مقترَحة للتعامل مع الصور | تأكَّد من أنّ قيمة الحقل
adwords_redirect هي عنوان URL صالح. |
| نصائح للوقاية من الفيروس | غير متاح |
[item] auth/frontend/not_claimed |
|
| ملخّص | لم تتم المطالبة بعنوان URL الخاص بالموقع الإلكتروني للتاجر في Merchant Center. |
| الأسباب الشائعة | غير متاح |
| نصائح مقترَحة للتعامل مع الصور | طالِب بعنوان URL في Merchant Center. يمكنك الاطّلاع على الإجراء التفصيلي لإجراء ذلك في مركز المساعدة. |
| نصائح للوقاية من الفيروس | غير متاح |
[energy_efficiency_class]
validation/feed |
|
| ملخّص | تم تحديد كل من energyEfficiencyClass
و
تسعير الوحدة للمنتج نفسه. |
| الأسباب الشائعة | غير متاح |
| نصائح مقترَحة للتعامل مع الصور | حدِّد فئة كفاءة استهلاك الطاقة أو سعر الوحدة فقط، وليس كليهما. |
| نصائح للوقاية من الفيروس | غير متاح |
[item] internal |
|
| ملخّص | حدث خطأ داخلي. |
| الأسباب الشائعة | غير متاح |
| نصائح مقترَحة للتعامل مع الصور | يُرجى إعادة محاولة إرسال الطلب. يُرجى التواصل معنا في حال تعذّر إكمالها باستمرار. |
| نصائح للوقاية من الفيروس | غير متاح |
[item_group_id] invalid_attribute |
|
| ملخّص | لقد أرسلت سلعة تحتوي على itemGroupId وقيم متعدّدة لسمة الخيار (اللون أو المقاس أو التصميم أو المادة الأساسية). |
| الأسباب الشائعة | تحديد أكثر من مقاس واحد لمنتج مع تحديد سمة معرّف مجموعة السلع. |
| نصائح مقترَحة للتعامل مع الصور | أرسِل منتجًا
مختلفًا لكل قيمة لسمة خيار منتج معيّن، مثل
size. |
| نصائح للوقاية من الفيروس | غير متاح |
[additional_image_link]
invalid_attribute |
|
| ملخّص | تم إرسال أكثر من 10 روابط صور إضافية. |
| الأسباب الشائعة | غير متاح |
| نصائح مقترَحة للتعامل مع الصور | الحدّ الأقصى لعدد روابط الصور الإضافية إلى 10. |
| نصائح للوقاية من الفيروس | غير متاح |
[<attribute>] invalid_character |
|
| ملخّص | تم إرسال علامة تجارية أو وصف أو سمة أخرى كسلسلة لا تحلّل المحتوى باستخدام ترميز الطلب المحدّد. |
| الأسباب الشائعة | غير متاح |
| نصائح مقترَحة للتعامل مع الصور | راجِع الرسالة لمعرفة السمة التي تسبّب المشكلة، ثم تحقّق من صحة ترميز النص للقيمة المقابلة قبل إعادة الإرسال. ولا تقبل واجهة برمجة التطبيقات سوى أحرف UTF-8 الصالحة. |
| نصائح للوقاية من الفيروس | غير متاح |
[<attribute>] invalid_value |
|
| ملخّص | تم إرسال لون أو وصف أو سمة أخرى غير صالحة. |
| الأسباب الشائعة | غير متاح |
| نصائح مقترَحة للتعامل مع الصور | وللتأكّد من تقيد جميع السمات بمواصفات الخلاصة، يمكنك مراجعة مقالة مركز المساعدة عن مواصفات الخلاصة للحصول على مزيد من المعلومات. لحلّ المشاكل المتعلقة برقم GTIN أو رقم القطعة المحدّد من الشركة المصنّعة (MPN)، يمكنك مراجعة مقالة "مركز المساعدة" حول المعرّفات الفريدة للمنتجات. |
| نصائح للوقاية من الفيروس | غير متاح |
[<attribute>]
missing_recommended / missing_required |
|
| ملخّص | أرسلت منتجًا بدون سمة مطلوبة أو سمة مُقترَحة. |
| الأسباب الشائعة | غير متاح |
| نصائح مقترَحة للتعامل مع الصور | تأكَّد من تضمين كل السمات المقترَحة أو المطلوبة لمنتجك. راجِع مقالة "مركز المساعدة" حول مواصفات الخلاصة للاطّلاع على مزيد من المعلومات. |
| نصائح للوقاية من الفيروس | غير متاح |
[link] validation/invalid_value for
<destinations>: URLs do not belong to your website |
|
| ملخّص | أرسلت منتجًا بعنوان URL أساسي يختلف عن عنوان URL الذي طالب به حساب Merchant Center. |
| الأسباب الشائعة | غير متاح |
| نصائح مقترَحة للتعامل مع الصور | تأكَّد من أنّ عناوين URL للمنتجات المرسَلة تتطابق مع الموقع الإلكتروني الذي طالبت به Merchant Center. |
| نصائح للوقاية من الفيروس | غير متاح |