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

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

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

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

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

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

‫Merchant API מתאים באופן אוטומטי את מכסות הקריאות ל:

• ‫products וaccounts על סמך השימוש שלכם.
• ‫datasources לחשבונות מתקדמים, בהתאם למספר חשבונות המשנה.

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

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

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

שינויים במכסת הפעלות method ב-Content API for Shopping

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

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

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

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

מכסה אוטומטית חלה על השירותים products, accounts ו-datasources.

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

משתמשים Quota increase requestבטופס יצירת קשר עם התמיכה וממלאים את הפרטים הבאים:

• מספר חשבון 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.

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

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

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