add_alert
חשוב: אנחנו נוציא משימוש את Content API for Shopping ב-18 באוגוסט 2026.
rocket
Meet
Merchant API
– the official successor to Content API for Shopping.
update
עדכונים אחרונים
לגבי תכונות חדשות, תיקוני באגים וגרסאות חדשות של Merchant API.
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
שגיאות נפוצות
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
אלה השגיאות הנפוצות ביותר:
בהמשך מופיעה רשימת השגיאות בסדר אלפביתי.
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, לדוגמה:
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 שופינג. |
| גורמים נפוצים | יכול להיות שמוצרים שלא עוברים את תהליך האימות עדיין יתווספו, אם הם לא מחליפים מוצר קיים ותקין. כדאי להשתמש בדגל 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 |
|---|
| סיכום | הבקשות נשלחות מהר מדי. צריך להפחית את תדירות הבקשות. |
| גורמים נפוצים | אפשר לעיין במכסות לדקה שמפורטות במגבלות שפורסמו. אם תחרגו מסכומי הסף האלה, תוצג השגיאה הזו. לפעמים יש עלייה חדה בנפח התנועה שגורמת לבעיה הזו, או שהשרת מתרחב למספר גדול יותר של שרשורים. |
| טיפים מומלצים לטיפול | הפחתת המספר הכולל של הבקשות שנשלחות בדקה. |
| טיפים למניעה | כשמקבלים את השגיאה הזו, צריך להשתמש באסטרטגיות השהיה מעריכית לפני ניסיון חוזר כדי להפחית את קצב הבקשות לרמה מתאימה ובת קיימא. |
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. |
| טיפים למניעה | צריך לוודא שרשומות בחבילה עם method
insert מציינות מוצר, ושרשומות בחבילה עם method
get
או
delete מציינות מזהה מוצר. |
[productId] DELETE request must specify
productId |
|---|
| סיכום | שלחת בקשה מותאמת אישית מקובצת אל ה-API
שכוללת רשומה עם "method": "delete" אבל בלי מזהה מוצר. |
| גורמים נפוצים | שכחת לשנות את השיטה ל-insert. |
| טיפים מומלצים לטיפול | מציינים מוצר למחיקה בשדה productID. |
| טיפים למניעה | צריך לוודא שרשומות בחבילה עם method
insert מציינות מוצר, ושרשומות בחבילה עם method
get
או
delete מציינות מזהה מוצר. |
userRateLimitExceeded
User Rate Limit
Exceeded |
|---|
| סיכום | הבקשות נשלחות מהר מדי. צריך להפחית את תדירות הבקשות. |
| גורמים נפוצים | אפשר לעיין במגבלות על בקשות HTTP שמפורטות במגבלות שפורסמו. אם תחרגו מסכומי הסף האלה, תקבלו את השגיאה הזו. לפעמים יש עלייה חדה בנפח התנועה שגורמת לכך, או שהשרת מתרחב למספר גדול יותר של תהליכים. |
| טיפים מומלצים לטיפול | הפחתת המספר הכולל של הבקשות שנשלחות בדקה. קיבוץ באצווה של כמה קריאות ל-method לאותו שירות לבקשת custombatch אחת יקטין את מספר בקשות ה-HTTP שמוגשות. |
| טיפים למניעה | כשמקבלים את השגיאה הזו, צריך להשתמש באסטרטגיות של עיבוד באצווה והשהיה לפני ניסיון חוזר כדי להקטין את קצב הבקשות לרמה מתאימה ובת קיימא. |
אימות
[adwords_redirect] |
|---|
| סיכום | שלחת מוצר שכתובת ה-URL שלו בשדה adwords_redirect
לא תקינה. |
| גורמים נפוצים | לא רלוונטי |
| טיפים מומלצים לטיפול | חשוב לוודא שהערך של השדה
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 |
|---|
| סיכום | שלחתם מותג, תיאור או מאפיין אחר כמחרוזת שלא עוברת ניתוח באמצעות קידוד הבקשה שצוין. |
| גורמים נפוצים | לא רלוונטי |
| טיפים מומלצים לטיפול | בודקים את ההודעה כדי לגלות איזה מאפיין גורם לבעיה, ואז מאמתים את קידוד הטקסט של הערך המתאים לפני ששולחים מחדש. ממשק ה-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 שהוגדרה בחשבון Merchant Center. |
| גורמים נפוצים | לא רלוונטי |
| טיפים מומלצים לטיפול | צריך לוודא שכתובות ה-URL של המוצרים שנשלחו תואמות לאתר שנתבעה עליו בעלות ב-Merchant Center. |
| טיפים למניעה | לא רלוונטי |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2026-07-06 (שעון UTC).
[null,null,["עדכון אחרון: 2026-07-06 (שעון UTC)."],[],["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"]]