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

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

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

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

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

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

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

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

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

בתרשים מוצגת ההיררכיה של קבוצות 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. אם אתם צריכים להגדיל את המכסה של שירות אחר, אם הגעתם למכסה היומית של שירותי 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[]
הקודם
Manage conversion sources
הבא
Track usage metrics