בעיות ידועות

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

תגובות לסירוגין מ-INTERNAL_ERROR

תאריך הדיווח: 2026-06-29 UTC

קיבלנו דיווחים על תגובות לסירוגין של INTERNAL_ERROR שמשפיעות על שיטות שונות של API. שיעור השגיאות הוא בדרך כלל בסביבות 0.1%, אבל לפעמים הוא יכול להיות קצת יותר גבוה.

אנחנו פועלים לפתרון הבעיה. בינתיים, אם נתקלת בשגיאות האלה, מומלץ לנסות לשלוח את הבקשה שוב. אם אתם רואים שיעורי שגיאה גבוהים, פנו לתמיכה.

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

תאריך הדיווח: 30 במרץ 2026 לפי שעון UTC | תאריך העדכון האחרון: 17 באפריל 2026 לפי שעון UTC

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

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

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

הדיווח: 2026-03-18 UTC | העדכון האחרון: 2026-05-13 UTC

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

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

בעיות בתפוקה של שיטות 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. השדה הזה מספק את שם המשאב לפני הקידוד, כך שאפשר להשתמש בפלט של רשימה או לקבל קריאה ישירות כקלט לעדכונים הבאים בלי לבצע קידוד ידני.

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

תאריך הדיווח: 2024-04-10 UTC | תאריך העדכון האחרון: 2024-05-12 UTC

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

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

יש בעיה אחרת?

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

הקודם
Versioning
הבא
Overview