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