לפניכם השגיאות הנפוצות ביותר:
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' |
|
| סיכום | ניסיתם לעדכן את המחיר והזמינות של
מוצר אונליין דרך פיד המלאי, אבל ציינתם בכתובת ה-URL משהו אחר מלבד הערך המיוחד online כמזהה החנות. |
| גורמים נפוצים | לא רלוונטי |
| טיפים מומלצים לטיפול | משנים את מזהה החנות
ל-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 שופינג. |
| גורמים נפוצים | עדיין אפשר להוסיף מוצרים שלא יעברו את האימות, אם הם לא מחליפים מוצר קיים ותקף. כדאי להשתמש בדגל
includeInvalidInsertedItems כדי לציין
Productstatuses.list כדי לוודא שאין בחשבון מספר גדול של מוצרים לא חוקיים. |
| טיפים מומלצים לטיפול | צריך לבדוק ולהסיר מספרים מיותרים של מוצרים לא תקינים, כפי שצוין למעלה. בנוסף, צריך לציין תאריכי תפוגה כשמעלים מוצרים. כשתגיעו לתאריך התפוגה, המוצר יימחק באופן אוטומטי. חשוב לזכור שברירת המחדל, תאריך התפוגה המקסימלי הוא 30 יום לאחר ההוספה או העדכון של המוצר. הערה: מכסת הפריטים בחשבון מרובה לקוחות נבדקת מול מספר המוצרים הכולל בכל חשבונות המשנה. אם השגיאה הזו מופיעה בחשבון משנה, צריך לוודא שבחשבון המשנה ובחשבון ה-MCA יש מספיק מכסת מוצרים. אם ניסית את הפתרונות האלה ועדיין נגמר לך המקום באחסון למוצרים חדשים בחשבון Merchant Center, אפשר לבקש שתהיה לך אפשרות לשלוח פריטים נוספים בחשבון. |
| טיפים למניעה | כדאי לעיין בטיפים מומלצים לטיפול. |
too_many_subaccounts:
Maximum number of subaccounts reached |
|
| סיכום | הגעת למספר חשבונות המשנה המקסימלי המותר לחשבון מרובה הלקוחות שלך. |
| גורמים נפוצים | לא רלוונטי |
| טיפים מומלצים לטיפול | מחיקת חשבונות משנה ישנים. אם כל החשבונות שלך פעילים, אפשר לבקש שתהיה לך אפשרות ליצור עוד חשבונות משנה בחשבון ה-MCA. |
| טיפים למניעה | לא רלוונטי |
request_rate_too_high:
Request rate too high. Please reduce your throughput |
|
| סיכום | הבקשות נשלחות מהר מדי, ולכן יש לצמצם את תדירות הבקשות. |
| גורמים נפוצים | המכסות לדקה מפורטות במגבלות על פרסום. אם חורגים מערכי הסף האלה, מקבלים את השגיאה. לפעמים יש עלייה חדה בתנועת הגולשים שגורמת לכך, או שהשרת מתרחב למספר גדול יותר של תהליכונים. |
| טיפים מומלצים לטיפול | הפחתת מספר הבקשות הכולל שנשלחות בדקה. |
| טיפים למניעה | אם השגיאה הזו מופיעה, צריך להשתמש באסטרטגיות השהיה פרוגרמטיות לפני ניסיון חוזר (backoff) כדי להפחית את שיעור הבקשות לרמה מתאימה בת קיימא. |
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, והגודל של העברה דחוסה הוא 32Mb. |
| טיפים מומלצים לטיפול | צריך לפצל את האצווה לכמה קבוצות קבצים שלא חורגות מהמגבלה, ואז לנסות שוב. |
| טיפים למניעה | מומלץ לשלוח עד 1,000 רשומות בכל קבוצה. |
חובה
[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 שמפורטות במגבלות הפרסום. אם חורגים מערכי הסף האלה, מקבלים את השגיאה הזו. לפעמים יש עלייה חדה בתעבורת הנתונים שגורמת לכך, או שהשרת מתרחב למספר גדול יותר של שרשורים. |
| טיפים מומלצים לטיפול | הפחתת מספר הבקשות הכולל
שנשלחות בדקה. קיבוץ מספר קריאות method לאותו שירות בבקשת custombatch אחת יקטין את מספר בקשות ה-HTTP שנשלחות. |
| טיפים למניעה | כשתקבלו את השגיאה הזו, כדאי להשתמש באסטרטגיות קיבוץ באצווה ובהשהיה פרוגרמטית לפני ניסיון חוזר (backoff) כדי להפחית את שיעור הבקשות לרמה מתאימה של קיימוּת. |
אימות
[adwords_redirect] |
|
|---|---|
| סיכום | שלחתם מוצר שהשדה adwords_redirect שלו אינו כתובת URL חוקית. |
| גורמים נפוצים | לא רלוונטי |
| טיפים מומלצים לטיפול | מוודאים שהערך בשדה
adwords_redirect הוא כתובת URL חוקית. |
| טיפים למניעה | לא רלוונטי |
[item] auth/frontend/not_claimed |
|
| סיכום | לא נתבעה בעלות על כתובת האתר של המוכר ב-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 |
|
| סיכום | מותג, תיאור או מאפיין אחר נשלחו כמחרוזת שלא ניתנת לניתוח לפי קידוד הבקשה שצוין. |
| גורמים נפוצים | לא רלוונטי |
| טיפים מומלצים לטיפול | צריך לבדוק את ההודעה כדי לגלות איזה מאפיין גורם לבעיה, ואז לאמת את הקידוד של הטקסט של הערך המתאים לפני השליחה מחדש. ה-API מקבל רק תווי UTF-8 חוקיים. |
| טיפים למניעה | לא רלוונטי |
[<attribute>] invalid_value |
|
| סיכום | שלחתם צבע, תיאור או מאפיין אחר שאינו חוקי. |
| גורמים נפוצים | לא רלוונטי |
| טיפים מומלצים לטיפול | עליך לוודא שכל המאפיינים תואמים למפרט הפיד, לקבלת מידע נוסף זמין במאמר על מפרט הפיד במרכז העזרה. אם יש בעיות שקשורות למספר GTIN או לקוד MPN, אפשר לעיין במאמר במרכז העזרה בנושא מזהי מוצר ייחודיים (UPI). |
| טיפים למניעה | לא רלוונטי |
[<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 תבע עליו בעלות. |
| טיפים למניעה | לא רלוונטי |