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

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

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

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

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

שינויים שקשורים למכסות בין Merchant API לבין Content API for Shopping

• המכסה תיספור לכל משאב, ולא לכל שיטה. כלומר, חלק מהשירותים מקושרים עכשיו.
• היעדר קיבוץ מותאם אישית לא משפיע על חישוב המכסות. לדוגמה, בקשת אצווה שמכילה 500 בקשות להוספה (insert) תחויב כ-500 בקשות נפרדות של שיטת ההוספה.
• האוטומציה של המכסות לחשבונות ולמוצרים תישאר בתוקף.
• כדי לקבוע את המגבלות והשימוש הנוכחיים במכסות, כולל אוטומציה ועקיפות, משתמשים בשיטה Quota.list.

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

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

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

• המכסות הן לכל שיטה. לדוגמה, לשיטה get יש מכסה נפרדת מהשיטה update.
• כל בקשה נספרת פעם אחת, ללא קשר לסוג שלה. לדוגמה, אנחנו סופרים בקשת list של 250 פריטים פעם אחת, ולא כ-250 בקשות get.
• החיוב על המכסה מתבצע על סמך המשתמש שמגיש את בקשת ה-API. אם המשתמש הוא חבר ישיר בחשבון מתקדם, המכסה תחויב ברמת החשבון המתקדם.
• המכסות חלות על הקבוצה, החשבון, ה-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[]