מכסות מגנות על התשתית של Google מפני תהליכים אוטומטיים שמשתמשים ב-Campaign Manager 360 API בצורה לא הולמת. הם מבטיחים שפעולות של מפתח אחד לא יוכלו להשפיע לרעה על הקהילה הרחבה יותר.
מגבלות המכסה
מגבלות המכסה הבאות שמוגדרות כברירת מחדל משותפות לכל המשאבים והשיטות של Campaign Manager 360 API.
- 50,000 בקשות לכל פרויקט ביום – אפשר להגדיל את המכסה.
- שאילתה אחת לשנייה (QPS) לכל פרויקט.
- במסוף Google API, המכסה הזו נקראת Queries per minute per user (שאילתות לדקה לכל משתמש), והיא מוגדרת כ-60 כברירת מחדל. אפשר להגדיל את המכסה הזו לפי הצורך, עד למקסימום של 600 (10 QPS).
בכלי ליצירת דוחות יש מגבלות נוספות על מכסות, שמשתנות בהתאם לחשבון. מידע נוסף זמין במאמר הזה במרכז העזרה ובטבלה שלמטה.
חריגה ממגבלות המכסה
במקרה הלא סביר שהבקשה תיכשל בגלל חריגה ממגבלת מכסה, ה-API יחזיר קוד סטטוס HTTP וסיבה לשגיאה. בנוסף, גוף התשובה מכיל תיאור מפורט של הגורם לשגיאה. דוגמה לתגובה עם שגיאה מופיעה במדריך הודעות שגיאה.
ברשימה הבאה מפורטות השגיאות האפשריות והפעולות המומלצות במקרים של בקשות שנכשלו בגלל חריגה ממגבלות המכסה.
| קוד | סיבה | שליחת הודעה | הפעולה המומלצת |
|---|---|---|---|
| 403 | dailyLimitExceeded | חריגה מהמגבלה היומית | אל תנסו שוב בלי לפתור את הבעיה. בודקים את השימוש ב-Google API Console ומשנים את תהליך העבודה כדי לשלוח פחות בקשות. אם אתם חושבים שהשימוש שלכם סביר, אתם יכולים לבקש מכסה נוספת. |
| 403 | quotaExceeded | נרשמה חריגה מהמכסה של x דוחות ליום שהוקצתה לחשבון הזה. | אל תנסו להריץ עוד דוחות לגבי החשבון הזה היום. לקבלת עזרה, צריך לפנות למנהל החשבון. |
| 403 | quotaExceeded | פרופיל המשתמש הזה חרג מהמכסה של x דוחות ליום. | אל תנסו להריץ עוד דוחות עבור פרופיל המשתמש הזה היום. צריך לעבור לפרופיל משתמש אחר או לפנות למנהל החשבון לקבלת עזרה. |
| 403 | quotaExceeded | נרשמה חריגה מהמכסה של x דוחות פעילים בלוח הזמנים שהוקצתה לחשבון הזה. | לפני שמנסים שוב לשלוח את הבקשה, צריך להשבית את הדוחות המתוזמנים שלא נדרשים. |
| 403 | quotaExceeded | פרופיל המשתמש שבבעלותו הדוח הזה חרג מהמכסה של x דוחות פעילים בלוח הזמנים. | בעל הדוח צריך להשבית דוחות מתוזמנים שהוא לא צריך לפני שמנסים שוב לשלוח את הבקשה הזו. |
| 403 | quotaExceeded | פרופיל המשתמש הזה חרג מהמכסה של x דוחות פעילים בלוח הזמנים. | לפני שמנסים שוב לשלוח את הבקשה, צריך להשבית את הדוחות המתוזמנים שלא נדרשים. |
| 403 | quotaExceeded | לא ניתן להשלים פעולה זו מאחר שאירעה חריגה מאחת מהמכסות שלך. פנה למנהל החשבון שלך לקבלת סיוע. | לקבלת עזרה, צריך לפנות למנהל החשבון. |
| 403 | userRateLimitExceeded | חריגה ממגבלת הקצב של יצירת בקשות לכל משתמש | אפשר להגדיל את המגבלה לכל משתמש ב-Google API Console או להאט את קצב שליחת הבקשות באמצעות נסיגה אקספוננציאלית. לא מומלץ לשלוח בקשות כתיבה בו-זמניות או להשתמש בהגבלת קצב גבוהה מ-10 QPS עם ה-API הזה. |
שליחת בקשה להגדלת המכסה היומית
אם לדעתכם האפליקציה שלכם זקוקה למכסת שימוש יומית נוספת, אתם יכולים לבקש מכסה גדולה יותר באמצעות ההוראות שבהמשך.
ההוראות הבאות רלוונטיות רק לפרויקטים שבהם מופיעה השגיאה dailyLimitExceeded. הפעולות המומלצות לפתרון שגיאות אחרות שקשורות למכסות מפורטות בטבלה שלמעלה.
- עוברים אל Campaign Manager 360 API ב-Google API Console.
- כדאי לעיין בנתוני השימוש בדף מדדים כדי לוודא שהאפליקציה מתנהגת כמצופה. חשוב לשים לב לשיטות שהופעלו ולטפל בכל שימוש לא צפוי או מוגזם לפני שממשיכים.
- אם השימוש נראה תקין, עוברים לדף Quotas (מכסות), לוחצים על סמל העריכה לצד Queries per day (שאילתות ליום) ולוחצים על הקישור 'Apply for higher quota' (בקשה להגדלת המכסה).
חשוב לקרוא את המידע ולפעול לפי ההוראות שמופיעות בטופס בקשת הגדלת נפח האחסון לפני ששולחים בקשה להגדלה.