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