در زیر لیستی از خطاها به ترتیب حروف الفبا آورده شده است.
auth/account_access_denied
User cannot access account <account_number>
خلاصه
درخواستی برای هدف قرار دادن حسابی که کاربر احراز هویت شده به آن دسترسی ندارد صادر کرد.
علل شایع
خطا در شناسه تاجر مورد نظر یا فراموش کردن ثبت نام کاربر در Merchant Center.
نکاتی برای دست زدن
بررسی کنید که حساب درستی را هدف قرار داده اید یا خود را به عنوان کاربر این حساب در Merchant Center ثبت کنید ( تنظیمات > کاربران ).
نکات پیشگیری
NA
User is not an administrator of account <account_number>
خلاصه
درخواستی برای تغییر حسابی که کاربر احراز هویت شده برای آن هیچ حقوق سرپرستی ندارد، صادر کرد.
علل شایع
NA
نکاتی برای دست زدن
حقوق مدیریت را برای کاربر تأیید شده تنظیم کنید.
نکات پیشگیری
NA
تعارض
[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 برای یک فروشنده و کد فروشگاه خودداری کنید یا مطمئن شوید که این تماسها حاوی محصولات همپوشانی نیستند.
خطای داخلی
Internal error
خلاصه
مشکلی در پشتیبان Google وجود دارد.
علل شایع
NA
نکاتی برای دست زدن
درخواست را دوباره امتحان کنید. در صورت شکست مداوم با ما تماس بگیرید .
نکات پیشگیری
NA
بی اعتبار
Invalid channel: '<channel>'
خلاصه
کانال نامعتبر به عنوان بخشی از شناسه محصول ارائه شده است. به عنوان مثال: not_a_channel:en:US:sku123 .
علل شایع
NA
نکات دست زدن به توصیه شده
NA
نکات پیشگیری
مطمئن شوید که شناسه محصول شما به شکل channel:languageCode:countryCode:offerId باشد، برای مثال: online:en:US:sku123 . برای اطلاعات بیشتر، به مستندات مرجع برای Products.insert مراجعه کنید.
[countrycode] Invalid country code: '<country_code>'
خلاصه
کد کشور نامعتبر به عنوان بخشی از شناسه محصول ارائه شده است. به عنوان مثال: online:en:not_a_country_code:sku123 .
علل شایع
NA
نکاتی برای دست زدن
NA
نکات پیشگیری
مطمئن شوید که شناسه محصول شما به شکل channel:languageCode:countryCode:offerId و کد کشور یک کد کشور ISO 3166 معتبر باشد.
[item id] Invalid item id: '<id>'
خلاصه
شناسه مورد نامعتبر است، به عنوان مثال، sku123 به جای online:en:US:sku123 .
علل شایع
تعیین شناسه پیشنهاد به جای شناسه محصول در درخواست GET یا DELETE .
نکاتی برای دست زدن
NA
نکات پیشگیری
مطمئن شوید شناسه محصول شما به شکل channel:languageCode:countryCode:offerId .
سعی کرد قیمت و در دسترس بودن یک محصول آنلاین را از طریق فید موجودی بهروزرسانی کند، اما چیزی غیر از ارزش ویژه online را به عنوان شناسه فروشگاه در URL مشخص کرد.
علل شایع
NA
نکاتی برای دست زدن
شناسه فروشگاه را در URL درخواست به online تغییر دهید.
نکات پیشگیری
مطمئن شوید که online برای محصولات آنلاین و شناسه فروشگاه برای محصولات محلی را در تمام جستجوهای موجودی خود مشخص کرده اید.
موردی که سعی کردید دریافت، بهروزرسانی یا حذف کنید وجود ندارد.
علل شایع
تلاش برای حذف محصولی که وجود ندارد، یا مشخص نکردن شناسه محصول به درستی در URL برای حذف.
نکات دست زدن به توصیه شده
فهرستی از محصولات را با استفاده از Products.list دریافت کنید و فقط سعی کنید مواردی را که در آنجا ظاهر میشوند را دریافت، بهروزرسانی یا حذف کنید. مطمئن شوید که شناسه محصول را در فرم channel:languageCode:countryCode:offerId مشخص کرده اید، به عنوان مثال: online:ru:RU:277104-ekb به جای شناسه پیشنهاد، که به شکل زیر است: 277104-ekb .
نکات پیشگیری
NA
not_inserted
The item could not be inserted.
خلاصه
به دلیل سایر خطاها، محصول نمی تواند درج شود زیرا یک ورودی خوب موجود را بازنویسی می کند.
علل شایع
NA
نکات دست زدن به توصیه شده
سایر خطاها را برای همان تماس بررسی کنید و قبل از تلاش برای درج مجدد اطلاعات محصول جدید، آنها را برطرف کنید.
نکات پیشگیری
NA
سهمیه، سهم
too_many_items: Merchant quota exceeded
خلاصه
موارد بسیار زیادی در Google Shopping آپلود شده است.
علل شایع
محصولاتی که اعتبارسنجی نمیشوند ممکن است همچنان درج شوند، اگر جایگزین محصول معتبر موجود نشوند. استفاده از پرچم includeInvalidInsertedItems را در Productstatuses.list در نظر بگیرید تا مطمئن شوید حساب شما دارای تعداد بیش از حد محصولات نامعتبر نیست.
نکاتی برای دست زدن
همانطور که در بالا ذکر شد، تعداد بیش از حد محصولات نامعتبر را بررسی و حذف کنید. علاوه بر این، هنگام بارگذاری محصولات، تاریخ انقضا را مشخص کنید. پس از رسیدن به تاریخ انقضا، محصول به طور خودکار حذف می شود. به خاطر داشته باشید که تاریخ انقضای پیشفرض و حداکثر 30 روز پس از درج یا بهروزرسانی محصول است.
توجه : سهمیه اقلام برای حساب چند مشتری با تعداد کل محصولات در همه حسابهای فرعی بررسی میشود. اگر این خطا را با یک حساب فرعی دریافت کردید، مطمئن شوید که هم حساب فرعی و هم MCA شما دارای سهمیه محصول کافی هستند.
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 فراتر می روید.
علل شایع
شما می توانید حداکثر 10000 entries در هر درخواست custombatch وارد کنید و محدودیت اندازه انتقال فشرده 32 مگابایت است.
نکات دست زدن به توصیه شده
دسته را به چند دسته که کمتر از حد مجاز هستند تقسیم کنید، سپس دوباره امتحان کنید.
نکات پیشگیری
توصیه می کنیم بیش از 1000 ورودی در هر دسته ارسال نکنید.
ضروری
[price.value] Required parameter: price.value
خلاصه
قیمتی بدون ارزش مشخص کرد. برای مثال: { "currency": "USD" } به جای { "value": 123, "currency": "USD" } .
علل شایع
NA
نکات دست زدن به توصیه شده
مطمئن شوید که پارامتر، در اینجا price ، به خوبی شکل گرفته است. به عنوان مثال، price دارای دو فیلد اجباری است: value و currency .
نکات پیشگیری
NA
[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 معتبر نیست.
نام تجاری، توضیحات یا ویژگی دیگری را به عنوان رشته ای ارسال کرد که با استفاده از رمزگذاری درخواست مشخص شده تجزیه نمی شود.
علل شایع
NA
نکات دست زدن به توصیه شده
پیام را بررسی کنید تا متوجه شوید کدام ویژگی مشکل را ایجاد کرده است، سپس رمزگذاری متن مقدار مربوطه را قبل از ارسال مجدد تأیید کنید. API فقط نویسه های معتبر UTF-8 را می پذیرد.
نکات پیشگیری
NA
[<attribute>] invalid_value
خلاصه
رنگ، توضیحات یا ویژگی دیگری را ارسال کرد که معتبر نیست.
محصولی را بدون ویژگی مورد نیاز/توصیه شده ارسال کرد.
علل شایع
NA
نکات دست زدن به توصیه شده
اطمینان حاصل کنید که تمام ویژگی های توصیه شده / مورد نیاز را برای محصول خود لحاظ کرده اید. برای اطلاعات بیشتر به مقاله مرکز راهنمای مشخصات فید مراجعه کنید.
نکات پیشگیری
NA
[link] validation/invalid_value for <destinations>: URLs do not belong to your website
خلاصه
محصولی را با نشانی اینترنتی اصلی که با نشانی اینترنتی ادعا شده توسط حساب Merchant Center متفاوت است، ارسال کرد.
تاریخ آخرین بهروزرسانی 2024-10-26 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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"]],["تاریخ آخرین بهروزرسانی 2024-10-26 بهوقت ساعت هماهنگ جهانی."],[[["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."]]],[]]