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

השימוש שלכם ב-Merchant API ובחשבון המוכר כפוף למכסות ולמגבלות.

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

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

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

מכסות של הפעלת method

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

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

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

בתרשים מוצגת ההיררכיה של קבוצות CSS, שירותי CSS, חשבונות וחשבונות משנה. קבוצת CSS היא רמת האימות הכוללת, עם אפשרות ל-CSS נפרד בתוכה, חשבונות בתוך אותם חשבונות וחשבונות משנה כרמה הכי נפרדת.

שינויים במכסות של קריאות לשיטות מ-Content API for Shopping

אם השתמשתם ב-Content API for Shopping, שימו לב לשינויים הבאים במכסת קריאות השיטה ב-Merchant API:

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

בדיקת מכסות השיחות

כדי לבדוק את מכסת השיחות הנוכחית ואת נפח השימוש בחשבון, מתקשרים אל 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

מגבלות החשבון

השיטות accounts.limits.get ו- accounts.limits.list מאפשרות לבדוק מגבלות על ישויות ברמת החשבון. אפשר להשתמש בשיטות האלה כדי לבדוק את מגבלות המוצרים.

כדי לאחזר מגבלת מוצר ספציפית, למשל כדי לקבל את מכסת המודעות באזור הכלכלי האירופי של חשבון מסוים, צריך לציין את מזהה החשבון ואת מזהה המגבלה בקריאה אל accounts.limits.get. מזהה המגבלה הוא שילוב של סוג המגבלה וההיקף שלה. לדוגמה, products~ADS_EEA למוצרים שמטורגטים למודעות באזור הכלכלי האירופי, ו-products~ADS_NON_EEA למוצרים שמטורגטים למודעות מחוץ לאזור הכלכלי האירופי.

הנה דוגמה לבקשה לקבלת המגבלה של products~ADS_EEA בחשבון נתון:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits/products~ADS_EEA

כדי לראות את מזהי המגבלות שזמינים בחשבון שלכם, משתמשים ב-accounts.limits.list עם מסנן ל-type="products":

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits?filter=type%3D%22products%22

מידע נוסף על מכסות מוצרים זמין במאמר הסבר על המכסות ב-Google Merchant Center.

מגבלות על ייצוג מקורות מידע

המגבלות הבאות מתארות הגבלות שחשוב להכיר על ערכים מסוימים של מחרוזות ושדות מערך בתוך ייצוגים של מקורות המידע שנעשה בהם שימוש ב-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[]