בעיות ידועות

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

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

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

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

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

• accounts.productInputs.insert
• accounts.products.localInventories.insert
• accounts.products.regionalInventories.insert

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

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

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

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

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

יש בעיה אחרת?

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