خطاهای رایج

اینها رایج‌ترین خطاها هستند:

در ادامه فهرستی از خطاها به ترتیب حروف الفبا آمده است.

مجوز/دسترسی_به_حساب_ممنوع شد

User cannot access account <account_number>
خلاصه درخواستی صادر شده که حسابی را هدف قرار می‌دهد که کاربر احراز هویت شده به آن دسترسی ندارد.
علل شایع خطا در شناسه فروشنده هدف یا فراموش کردن ثبت نام کاربر در مرکز فروشندگان.
نکات مربوط به جابجایی توصیه شده بررسی کنید که حساب کاربری درستی را هدف قرار داده‌اید یا خودتان را به عنوان کاربر حساب در مرکز فروشندگان ( تنظیمات > کاربران ) ثبت کنید.
نکات پیشگیری نه
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>
خلاصه همزمان چندین عملیات متضاد را امتحان کرد.
علل شایع یک درخواست دسته‌ای واحد شامل چندین عملیات متناقض برای یک محصول است، یا چندین عملیات متناقض برای یک محصول به طور همزمان به API محتوا ارسال شده است.
نکات مربوط به جابجایی توصیه شده نکات پیشگیری را ببینید.
نکات پیشگیری تمام تغییرات مربوط به یک محصول مشخص را در یک عملیات واحد در مجموعه‌ای از درخواست‌های دسته‌بندی‌شده لحاظ کنید. سعی کنید از چندین فراخوانی همزمان به API محتوا برای یک کد فروشگاه و فروشنده‌ی یکسان خودداری کنید، یا مطمئن شوید که این فراخوانی‌ها شامل محصولات همپوشانی نباشند.

خطای داخلی

Internal error
خلاصه مشکلی در بک‌اند گوگل وجود دارد.
علل شایع نه
نکات مربوط به جابجایی توصیه شده درخواست را دوباره امتحان کنید. اگر مرتباً ناموفق بود، با ما تماس بگیرید .
نکات پیشگیری نه

نامعتبر

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 مشخص کردم.
علل شایع نه
نکات مربوط به جابجایی توصیه شده شناسه فروشگاه را در URL درخواست به online تغییر دهید.
نکات پیشگیری مطمئن شوید که در تمام استعلام‌های موجودی خود، برای محصولات آنلاین، گزینه online و برای محصولات محلی، شناسه فروشگاه را مشخص می‌کنید.
[<attribute>]
خلاصه مورد مشخص شده در داخل کروشه معتبر نیست.
علل شایع نه
نکات مربوط به جابجایی توصیه شده برای اطلاعات بیشتر، مشخصات کالای مشکل‌دار را اصلاح کنید، به مقاله مرکز راهنمای مشخصات فید مراجعه کنید.
نکات پیشگیری نه

پیدا نشد

Item not found
خلاصه موردی که سعی در دریافت، به‌روزرسانی یا حذف آن داشتید، وجود ندارد.
علل شایع تلاش برای حذف محصولی که وجود ندارد، یا عدم ذکر صحیح شناسه محصول در URL برای حذف.
نکات مربوط به جابجایی توصیه شده با استفاده از Products.list لیستی از محصولات را دریافت کنید و فقط سعی کنید مواردی را که در آنجا ظاهر می‌شوند دریافت، به‌روزرسانی یا حذف کنید. مطمئن شوید که شناسه محصول را در فرم channel:languageCode:countryCode:offerId مشخص می‌کنید، برای مثال: online:ru:RU:277104-ekb به جای شناسه پیشنهاد که به این شکل است: 277104-ekb .
نکات پیشگیری نه

درج نشده

The item could not be inserted.
خلاصه به دلیل خطاهای دیگر، محصول قابل درج نبود زیرا ورودی موجود را رونویسی می‌کرد.
علل شایع نه
نکات مربوط به جابجایی توصیه شده خطاهای دیگر مربوط به همان فراخوانی را بررسی کنید و قبل از تلاش برای وارد کردن مجدد اطلاعات محصول جدید، آنها را برطرف کنید.
نکات پیشگیری نه

سهمیه

too_many_items: Merchant quota exceeded
خلاصه تعداد زیادی کالا در Google Shopping آپلود شده است.
علل شایع محصولاتی که اعتبارسنجی نمی‌شوند، در صورتی که جایگزین یک محصول معتبر موجود نشوند، همچنان می‌توانند درج شوند. استفاده از پرچم includeInvalidInsertedItems در Productstatuses.list در نظر بگیرید تا مطمئن شوید که حساب شما تعداد بیش از حدی از محصولات نامعتبر ندارد.
نکات مربوط به جابجایی توصیه شده

همانطور که در بالا ذکر شد، تعداد بیش از حد محصولات نامعتبر را بررسی و حذف کنید. علاوه بر این، هنگام آپلود محصولات، تاریخ انقضا را مشخص کنید. پس از رسیدن به تاریخ انقضا، محصول به طور خودکار حذف می‌شود. به خاطر داشته باشید که تاریخ انقضای پیش‌فرض و حداکثر، 30 روز پس از درج یا به‌روزرسانی محصول است.

توجه : سهمیه کالا برای یک حساب کاربری چند مشتریه در مقایسه با تعداد کل محصولات در تمام زیرحساب‌ها بررسی می‌شود. اگر این خطا را با یک زیرحساب دریافت کردید، مطمئن شوید که هم زیرحساب و هم MCA شما سهمیه محصول کافی دارند.

اگر این راه‌حل‌ها را امتحان کرده‌اید و هنوز در حساب مرکز فروشندگان خود با کمبود فضا برای محصولات جدید مواجه هستید، می‌توانید درخواست دهید که بتوانید اقلام بیشتری را در حساب خود ارسال کنید .

نکات پیشگیری به نکات توصیه شده در مورد نحوه‌ی استفاده مراجعه کنید.
too_many_subaccounts: Maximum number of subaccounts reached
خلاصه شما حداکثر تعداد حساب‌های فرعی مجاز برای حساب چندکاربره خود را دارید.
علل شایع نه
نکات مربوط به جابجایی توصیه شده

حساب‌های فرعی منسوخ‌شده را حذف کنید.

اگر همه حساب‌های شما فعال هستند، می‌توانید درخواست ایجاد حساب‌های فرعی اضافی در MCA خود را بدهید .

نکات پیشگیری نه
request_rate_too_high: Request rate too high. Please reduce your throughput
خلاصه درخواست‌ها خیلی سریع انجام می‌شوند؛ تعداد درخواست‌ها را کاهش دهید.
علل شایع به سهمیه‌های هر دقیقه ذکر شده در محدودیت‌های منتشر شده مراجعه کنید. اگر از این آستانه‌ها تجاوز کنید، این خطا را دریافت خواهید کرد. گاهی اوقات افزایش ناگهانی ترافیک باعث این امر می‌شود، یا سرور شما به تعداد بیشتری از نخ‌ها گسترش می‌یابد.
نکات مربوط به جابجایی توصیه شده کاهش تعداد درخواست‌های ارسالی در هر دقیقه.
نکات پیشگیری وقتی این خطا را دریافت می‌کنید، از استراتژی‌های برنامه‌ریزی‌شده‌ی کاهش سرعت (back-off) برای کاهش نرخ درخواست به یک سطح پایدار و مناسب استفاده کنید.
daily_limit_exceeded: merchant quota exceeded
خلاصه شما بیش از تعداد مجاز درخواست در روز برای روش سرویس داده شده ارسال می‌کنید.
علل شایع به سهمیه‌های روزانه ذکر شده در محدودیت‌های منتشر شده مراجعه کنید. اگر از این آستانه‌ها تجاوز کنید، این خطا را دریافت خواهید کرد.
نکات مربوط به جابجایی توصیه شده

در صورت امکان، با ترکیب چندین تغییر در یک درخواست واحد، تعداد کل درخواست‌های ارسالی در روز را کاهش دهید. برای جلوگیری از تغییر سریع یک محصول در چندین نوبت، تغییرات دسته‌ای روی محصولات را در یک دوره زمانی مناسب در نظر بگیرید. برای به‌روزرسانی‌های اقلامی که می‌توانند به عنوان ریزداده در وب‌سایت شما نمایش داده شوند، استفاده از این رویکرد را برای محدود کردن تعداد تماس‌ها با سرویس‌های Products یا Inventory در نظر بگیرید.

اگر هنوز به تماس‌های روزانه بیشتری با یک روش خاص نیاز دارید، لطفاً با ما تماس بگیرید و شناسه مرکز پذیرندگان خود، محدودیت‌های سهمیه‌ای که در کدام روش‌ها اعمال می‌کنید، تخمین تعداد تماس‌های مورد نیاز در روز برای آن روش‌ها و دلیل آن را به ما اطلاع دهید، و ما با شما همکاری خواهیم کرد تا سهمیه شما افزایش یابد.

نکات پیشگیری به نکات توصیه شده در مورد نحوه‌ی استفاده مراجعه کنید.
too_many_failed_auths: Too many failed authentications.
خلاصه شما درخواست‌های دسته‌ای زیادی برای حساب‌هایی که به آنها دسترسی ندارید، ارسال می‌کنید.
علل شایع درخواست‌های دسته‌ای برای حساب‌های فرعی که حذف شده‌اند یا برای حساب‌های فرعی تازه ایجاد شده قبل از در دسترس بودن آنها.
نکات مربوط به جابجایی توصیه شده از برقراری تماس‌هایی که روی حساب کاربری فرعی حذف شده تأثیر می‌گذارند، خودداری کنید.
نکات پیشگیری به نکات توصیه شده در مورد نحوه‌ی استفاده مراجعه کنید.
request_too_large
خلاصه شما در هر درخواست دسته‌ای، entries زیادی ارسال می‌کنید، یا از محدودیت اندازه درخواست custombatch فراتر رفته‌اید.
علل شایع شما می‌توانید حداکثر ۱۰،۰۰۰ entries در هر درخواست custombatch وارد کنید و محدودیت اندازه انتقال فشرده ۳۲ مگابایت است.
نکات مربوط به جابجایی توصیه شده دسته را به چندین دسته تقسیم کنید که کمتر از محدودیت‌ها باشند، سپس دوباره امتحان کنید.
نکات پیشگیری توصیه می‌کنیم در هر دسته بیش از ۱۰۰۰ ورودی ارسال نکنید.

مورد نیاز

[price.value] Required parameter: price.value
خلاصه قیمت را بدون مقدار مشخص کرد. برای مثال: { "currency": "USD" } به جای { "value": 123, "currency": "USD" } .
علل شایع نه
نکات مربوط به جابجایی توصیه شده مطمئن شوید که پارامتر، در اینجا price ، به درستی شکل گرفته باشد. برای مثال، price دو فیلد اجباری دارد: value و currency .
نکات پیشگیری نه
[product] INSERT request must specify product
خلاصه یک درخواست دسته‌ای سفارشی به API ارسال شد که حاوی ورودی با "method": "insert" بود اما محصولی نداشت.
علل شایع فراموش کردن تغییر روش get یا delete .
نکات مربوط به جابجایی توصیه شده یک محصول را برای درج از طریق فیلد product مشخص کنید.
نکات پیشگیری مطمئن شوید که ورودی‌های دسته‌ای با متد insert ، یک محصول را مشخص می‌کنند و ورودی‌های دسته‌ای با متد get یا delete یک شناسه محصول را مشخص می‌کنند.
[productId] DELETE request must specify productId
خلاصه یک درخواست دسته‌ای سفارشی به API ارسال شد که حاوی ورودی با "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) درخواست کنید. روش دقیق انجام این کار در مرکز راهنما (Help Center) موجود است.
نکات پیشگیری نه
[energy_efficiency_class] validation/feed
خلاصه هم energyEfficiencyClass و هم قیمت‌گذاری واحد را برای یک محصول مشخص کرده است.
علل شایع نه
نکات مربوط به جابجایی توصیه شده فقط کلاس بهره‌وری انرژی یا قیمت واحد را مشخص کنید، نه هر دو را.
نکات پیشگیری نه
[item] internal
خلاصه یک خطای داخلی.
علل شایع نه
نکات مربوط به جابجایی توصیه شده درخواست را دوباره امتحان کنید. اگر مرتباً ناموفق بود، با ما تماس بگیرید .
نکات پیشگیری نه
[item_group_id] invalid_attribute
خلاصه یک آیتم با itemGroupId و مقادیر زیادی برای یک ویژگی متغیر (رنگ، ​​اندازه، الگو یا جنس) ارسال شد.
علل شایع تعیین بیش از یک اندازه برای یک محصول هنگام تعیین شناسه گروه کالا.
نکات مربوط به جابجایی توصیه شده برای هر مقدار از یک ویژگی متغیر مشخص، مانند size یک محصول متفاوت ارسال کنید.
نکات پیشگیری نه
[additional_image_link] invalid_attribute
خلاصه بیش از ۱۰ لینک تصویر دیگر ارسال شد.
علل شایع نه
نکات مربوط به جابجایی توصیه شده تعداد لینک‌های تصویر اضافی را به ۱۰ عدد محدود کنید.
نکات پیشگیری نه
[<attribute>] invalid_character
خلاصه یک برند، توضیحات یا ویژگی دیگر را به صورت رشته‌ای ارسال کرده است که با استفاده از کدگذاری درخواست مشخص شده تجزیه نمی‌شود.
علل شایع نه
نکات مربوط به جابجایی توصیه شده پیام را بررسی کنید تا بفهمید کدام ویژگی باعث ایجاد مشکل شده است، سپس قبل از ارسال مجدد، کدگذاری متن مقدار مربوطه را اعتبارسنجی کنید. API فقط کاراکترهای معتبر 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 ادعا شده توسط حساب مرکز فروشندگان متفاوت است.
علل شایع نه
نکات مربوط به جابجایی توصیه شده مطمئن شوید که آدرس‌های اینترنتی (URL) محصولات ارسالی با وب‌سایت ادعا شده توسط مرکز فروشندگان مطابقت دارند.
نکات پیشگیری نه