הוגשה בקשה שמטרגטת חשבון שאין למשתמש המאומת גישה אליו.
גורמים נפוצים
שגיאה במזהה המוכר היעד או שכחתם לרשום את המשתמש ב-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.
ניסיון למחוק מוצר שלא קיים, או אי ציון נכון של מזהה המוצר בכתובת ה-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
סיכום
הגעתם למספר המקסימלי של חשבונות משנה שמותר ליצור בחשבון שלכם עם כמה לקוחות.
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, והמגבלה על גודל ההעברה הנדחסת היא 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 שנשלחות.
טיפים למניעה
אם קיבלתם את השגיאה הזו, כדאי להשתמש באסטרטגיות של ארגון בקשות בקבוצות ובאסטרטגיות פרוגרמטיות של השהיה לפני ניסיון חוזר כדי להפחית את קצב הבקשות לרמה מתאימה ומתמשכת.
אימות
[adwords_redirect]
סיכום
שלחתם מוצר שבו השדה adwords_redirect הוא לא כתובת URL חוקית.
שלחתם מותג, תיאור או מאפיין אחר כמחרוזת שלא ניתן לנתח באמצעות קידוד הבקשה שצוין.
גורמים נפוצים
לא רלוונטי
טיפים מומלצים לטיפול
בודקים את ההודעה כדי לברר איזה מאפיין גורם לבעיה, ואז מאמתים את קידוד הטקסט של הערך התואם לפני ששולחים אותו מחדש. ממשק ה-API מקבל רק תווים תקינים בתקן UTF-8.
[[["התוכן קל להבנה","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 (שעון UTC)."],[[["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"]]
