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