מכסות ומגבלות

למאפיינים של Merchant API יש מכסות והגבלות מחמירות.

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

עדכון המדיניות

ב-Merchant API נאכפים כללי המדיניות הבאים בנוגע לעדכונים:

• אפשר לעדכן את המוצרים רק עד פעמיים ביום.
• אפשר לעדכן את חשבונות המשנה רק פעם ביום.

מכסות להפעלת שיטות

Merchant API מתאים באופן אוטומטי את מכסות הקריאות של products ושל accounts בהתאם לשימוש שלכם.

כך אנחנו עוקבים אחרי השימוש במכסות:

• המכסות הן לכל שיטה. לדוגמה, לשיטה get יש מכסה נפרדת מהשיטה update.
• כל בקשה נספרת פעם אחת, ללא קשר לסוג שלה. לדוגמה, אנחנו סופרים בקשת list של 250 פריטים פעם אחת, ולא כ-250 בקשות get.
• המכסות חלות על הקבוצה, החשבון, ה-CSS או החשבונות המשניים של שירותי השוואת המחירים (CSS) שבהם אתם מבצעים אימות כשאתם מבצעים את הקריאה. לדוגמה, אם מבצעים אימות כחשבון מתקדם, השיחות נספרות במכסת החשבון המתקדם. לעומת זאת, אם מבצעים אימות כאחד מהחשבונות המשניים, השיחות נספרות במכסת החשבון המשני.

בתרשים מוצגת היררכיית קבוצות ה-CSS, שירותי ה-CSS, החשבונות וחשבונות המשנה.

בדיקת המכסות

כדי לבדוק את המכסה הנוכחית ואת נפח השימוש בחשבון, צריך להריץ את הפקודה quotas.list עם name של החשבון.

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

• מספר החשבון ב-Merchant Center
• השיטות שבהן הגעתם למגבלות המכסות
• אומדן של מספר הקריאות הנדרשות ליום בשיטות האלה
• הסיבה להגדלת המכסה
• אם מדובר בעלייה זמנית או קבועה

מומלץ לבדוק את המכסות שלכם מדי פעם כדי לוודא שיש לכם מספיק מכסה להטמעה, או כדי לבדוק איך המכסה מותאמת באופן אוטומטי.

שגיאות

אם תחרגו מהמכסות, יוצגו לכם השגיאות הבאות:

• לדקה: quota/request_rate_too_high
• ליום: quota/daily_limit_exceeded

במאמר בדיקת המכסות מוסבר איך להציג את המכסות ואת השימוש, ואיך לבקש הגדלה של המכסה ליום או לדקה.

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

• too_many_items: Merchant quota exceeded
• too_many_subaccounts: Maximum number of sub-accounts reached

מגבלות על ייצוג משאבים

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

חשוב לזכור שזוהי רשימה חלקית של המגבלות. לא נרחיב את המגבלות האלה.

משאב	שדה	מגבלה
shippingsettings	שירותי משלוח לפי מדינה (services). קבוצות של שירותי משלוחים לכל שירות משלוחים (rateGroups). תוויות לכל קבוצת משלוחים (applicableShippingLabels). טבלאות משנה לכל קבוצת משלוח (subtables). מספר השורות או העמודות בטבלת שיעורי ריבית אחת. אורך תוויות המשלוח.	20 20 30 100 150 100

מספר השורות או העמודות בטבלת התעריפים משפיע על שדות המערך הבאים:

• שדות מערך ב-rowHeaders או ב-columnHeaders:
  • prices[]
  • weights[]
  • numberOfItems[]
  • postalCodeGroupNames[]
  • locations[]
  • rows[]
  • cells[]