בעיות ידועות

בדף הזה מפורטות בעיות ידועות שקשורות ל-Merchant API.

UnauthenticatedException שגיאות אקראיות

תאריך הדיווח: 2026-03-30 UTC

כמה לקוחות נתקלים בשגיאות לסירוגין ב-UnauthenticatedException API של Merchant Center כשמעלים מוצרים וניגשים ל-API אחרים של Merchant Center. שגיאות מתרחשות באופן אקראי, גם בניסיונות חוזרים, ומשפיעות גם על שיחות ראשוניות וגם על ניסיונות חוזרים. חלק מהחיבורים נכשלים ואחרים מצליחים תוך זמן קצר.

אין פתרון עקיף או המלצות בשלב הזה.

הודעות על זמן אחזור גבוה, DEADLINE_EXCEEDED ו-INTERNAL_ERROR לשיטות שקשורות למוצרים ולמלאי

דווח: 2026-03-18 UTC | נפתר: 2026-03-31 UTC

חלק מהמשתמשים חוו השהיה ממושכת והודעות תכופות של DEADLINE_EXCEEDED או INTERNAL_ERROR כשניסו להשתמש בשיטות productInputs ו-regionalInventories. הסיבה העיקרית שזוהתה היא אירוע ברמת ה-backend שמשפיע על יעילות העיבוד.

פתרון: האירוע הזה נפתר באופן מלא ב-31 במרץ 2026. לאחר הטיפול בבעיה, שיעורי השגיאות ירדו באופן משמעותי. אם הבעיה של זמן האחזור הארוך נמשכת, מומלץ לבדוק את פסק הזמן בצד הלקוח ולהקטין את גודל אצווה הבקשות.

בעיות בתפוקה של מוצרים ומלאי insert

תאריך הדיווח: 2026-01-28 (שעון UTC) | עדכון אחרון: 2026-03-31 (שעון UTC)

קיבלנו דיווחים על בעיות בביצועים בצד הלקוח עם קצב העברת נתונים (throughput) בזמן העברת כמויות גדולות של נתונים אל Merchant API. הבעיה הזו עשויה להופיע כשמשתמשים בספריות לקוח לשיטות הבאות:

ביצענו שיפורים כדי לשפר את הביצועים של מערכות בק-אנד שונות. אם הבעיה נמשכת, יכול להיות שתצטרכו להגדיר מאגר ערוצים כדי למקסם את קצב העברת הנתונים. השיטה הזו עוקפת את המגבלה הרגילה של 100 סטרימים בערוץ gRPC יחיד, על ידי ניהול של כמה חיבורים בסיסיים. למידע נוסף, אפשר לעיין במאמר בנושא שינוי מבנה הקוד לבקשות מקבילות: שיפור קצב העברת הנתונים באמצעות מאגרי ערוצים.

מזהי מוצרים עם תווים מיוחדים

Reported: 2025-10-03 UTC | Last Updated: 2026-04-08 UTC

יכול להיות שהמשתמשים ייתקלו בבעיות בניהול מוצרים שבהם הערכים של productId או offerId לא עומדים בדרישות של ההנחיות בנושא פורמט של מזהה מוצר. מזהי מוצרים כאלה עשויים להכיל תווים מיוחדים – בעיקר לוכסנים (/), נקודתיים (:), סימני טילדה (~) וסימני אחוז (%). בפלטפורמות כמו Merchant Center כבר מותרים תווים מיוחדים מסוימים במזהי מוצרים.

מכיוון ש-Merchant API משלב את מזהה המוצר ישירות במשאב name כחלק מכתובת ה-URL (לדוגמה accounts/{account}/products/{productId}), התווים האלה עלולים להפריע לניתוב ולניתוח של כתובות URL רגילות, ולגרום לשגיאות לא צפויות מסוג 404 Not Found או 400 Bad Request במהלך פעולות GET,‏ PATCH או DELETE.

כדי ליצור אינטראקציה בטוחה עם מוצרים שמכילים את התווים האלה, צריך לקודד את הקטע productId או offerId של שם המשאב. אלגוריתם הקידוד הוא קידוד Base64URL ללא ריפוד. מידע נוסף זמין במאמר accounts.productInputs.name.

נפתר: השקנו פתרון לסטנדרטיזציה של ההתנהגות בכל המערכת האקולוגית של Merchant API. הוספנו שדה חדש base64_encoded_name לתגובות של ה-API שמספק את שם המשאב שקודד מראש, כך שאפשר להשתמש בפלט של קריאת list או get ישירות כקלט לעדכונים הבאים בלי לבצע קידוד ידני.

השהיה אחרי יצירת מקור נתונים

תאריך הדיווח: 10 באפריל 2024 (UTC) | תאריך העדכון האחרון: 12 במאי 2024 (UTC)

הייתה השהיה ידועה בניסיון להוסיף מוצרים, מבצעים או ביקורות מיד אחרי יצירת DataSource חדש. השגיאה Data source not found הוחזרה כשניסיתם להוסיף פריטים תוך 5 דקות מיצירת מקור הנתונים.

הבעיה נפתרה: ביטלנו את העיכוב הזה, ועכשיו אפשר ליצור אינטראקציה מיידית עם מקורות נתונים חדשים.

יש בעיה אחרת?

אם נתקלתם בבעיות אחרות, אתם יכולים להיכנס לדפים קבלת עזרה בנושא Merchant API ושליחת משוב.