בדף הזה מפורטות בעיות ידועות של מפתחים ב-Merchant API.
בעיות בקצב העברת הנתונים בשיטות insert של מוצרים ומלאי
תאריך הדיווח: 28 בינואר 2026 (שעון UTC) | עדכון אחרון: 31 במרץ 2026 (שעון UTC)
קיבלנו דיווחים על בעיות בביצועים בצד הלקוח שקשורות לנפח הנתונים שמועבר ב-Merchant API. הבעיה הזו יכולה להופיע כשמשתמשים בספריות לקוח ב-methods הבאות:
accounts.productInputs.insertaccounts.products.localInventories.insertaccounts.products.regionalInventories.insert
ביצענו שיפורים כדי להגביר את הביצועים של מערכות בק-אנד שונות. אם הבעיה נמשכת, יכול להיות שתצטרכו להגדיר מאגר ערוצים כדי למקסם את קצב הנתונים. כך אפשר לעקוף את המגבלה הרגילה של 100 סטרימים בערוץ gRPC יחיד, על ידי ניהול של כמה חיבורים בסיסיים. למידע נוסף, קראו את המאמר Refactor code for concurrent requests: Improve throughput with channel pools.
מזהי מוצרים עם תווים מיוחדים
תאריך הדיווח: 3 באוקטובר 2025 לפי שעון UTC | תאריך העדכון האחרון: 8 באפריל 2026 לפי שעון 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 ושליחת משוב.