Google Ads API אוכף מגבלות על פעולות API, כמו מספר הפעולות שאפשר לשלוח בבקשת שינוי אחת. בטבלה הבאה מוצג סיכום של כמה מהמגבלות והמכסות החשובות שכדאי לשים לב אליהן.
סוג הבקשה, הגבלה וקוד שגיאה | |||
---|---|---|---|
בקשות מחולקות לדפים | 10,000 שורות בכל דף |
INVALID_PAGE_SIZE
|
|
פעולות עם גישה בסיסית | 15,000 פעולות API ביום |
RESOURCE_EXHAUSTED
|
|
בקשות שינוי | 10,000 פעולות לכל בקשה |
TOO_MANY_MUTATE_OPERATIONS
|
|
בקשות לשירות תכנון | QPS אחד |
RESOURCE_EXHAUSTED
|
|
בקשות לשירות העלאת המרות | 2,000 המרות לכל בקשה |
TOO_MANY_CONVERSIONS_IN_REQUEST
|
|
בקשות שירות של חיוב ותקציב חשבון | פעולה אחת לכל בקשת שינוי |
TOO_MANY_MUTATE_OPERATIONS
|
מגבלות יומיות על פעולות API
מגבלות השימוש היומיות ב-API מבוססות על מספר פעולות ה-API שבוצעו לכל קוד מפתח. פעולות API הן הסכום הכולל של בקשות להעברות ופעולות שינוי. המגבלות על הפעולות היומיות ב-API תלויות ברמת הגישה של קוד המפתח. במדריך רמות הגישה והשימוש המותר מפרט את מגבלות הפעולות הספציפיות ב-API לכל רמת גישה.
בקשות שמפרות את המגבלות האלה נדחות עם השגיאה: RESOURCE_EXHAUSTED
.
מגבלות gRPC
בכל ספריות הלקוח של Google Ads API נעשה שימוש ב-gRPC ליצירת בקשות ותגובות. כברירת מחדל, ל-gRPC יש גודל הודעה של 4MB, אבל ספריות הלקוח שלנו מגדירות את גודל ההודעה המקסימלי ל-64MB כדי לשפר את היעילות.
התשובות לא יכולות לחרוג מהמגבלה הזו. לדוגמה, בקשת חיפוש שכוללת הרבה שדות עשויה ליצור תשובה שגדולה מ-64MB. כדי למנוע את המגבלה הזו, אפשר לצמצם את מספר השדות שנבחרו, להקטין את גודל הדף או להשתמש בסטרימינג. לביצוע שינויים, צריך לשלוח פחות פעולות לכל בקשה.
בקשות שמפירות את המגבלה הזו לא ייצרו GoogleAdsError
, אבל ייצרו שגיאת gRPC מסוג 429 Resource Exhausted
. כאן אפשר למצוא רשימה של הודעות וקודי שגיאה של gRPC.
בקשות שינוי
בנוסף לספירה במכסת הפעולות היומית של המשתמש, בקשת שינוי לא יכולה לכלול יותר מ-10,000 פעולות לכל בקשה.
בקשות שמפרות את המגבלה הזו נדחות עם השגיאה: TOO_MANY_MUTATE_OPERATIONS
.
בהמשך מתוארות מגבלות ושיקולים נוספים לגבי שירותים וסוגים ספציפיים של בקשות.
בקשות חיפוש
בקשת Search
או SearchStream
נספרת כפעולה אחת במכסת הפעולות היומית של המשתמש. בקשת SearchStream
אחת נספרת כפעולת API אחת, ללא קשר למספר האצוות.
בקשות מחולקות לדפים
בקשות שעברו עימוד (לדוגמה, בקשות שמכילות ערך next_page_token
חוקי) לא נספרות במכסת הפעולות היומית של משתמש.
עם זאת, בקשות עימוד שמכילות אסימון דף שתוקפו פג או לא תקין יגרמו לחריגה וייספרו כחלק ממכסת הפעולות היומית.
בקשות שעוברות עימוד, כמו בקשות לחיפוש, כפופות גם הן למגבלה Page size cannot exceed 10,000 rows
ונדחות אם הן מפרות את המגבלה הזו עם השגיאה: INVALID_PAGE_SIZE
.
למידע נוסף על עימוד, ראו חלוקה בין תוצאות.
סוגים אחרים של בקשות
בקשה שאינה בקשת Get
, Mutate
, Search
או SearchStream
נספרת כפעולה אחת במכסת הפעולות היומית של המשתמש.
מספר דוגמאות לבקשות כאלה:
BatchJobService.ListMutateJobResults
ConversionUploadService.UploadCallConversions
ConversionUploadService.UploadClickConversions
OfflineUserDataJobService.AddOfflineUserDataJobOperations
OfflineUserDataJobService.CreateOfflineUserDataJob
UserDataService.UploadUserData
בקשות שמחזירות חריגות ב-API
בקשות שנדחו עם GoogleAdsFailure
עדיין נכללות במכסת הפעולות היומית של המשתמש.
בקשות שנכשלו אבל לא מחזירות GoogleAdsFailure
, למשל משגיאה ברמת הרשת, לא ייכללו במכסת הפעולות היומית של המשתמש, כי הבקשות לעולם לא יגיעו לשירות. דוגמה לכך היא כשל בקישוריות רשת.
שירותי תכנון
עקב העלות והמורכבות, שיטות השירות של Planning שמפורטות בהמשך כפופות למגבלות נפרדות מבקשות מסוגים אחרים.
מוגבל לבקשה אחת לשנייה לכל CID או קוד מפתח:
KeywordPlanService.GetKeywordPlan
KeywordPlanService.GenerateHistoricalMetrics
KeywordPlanService.GenerateForecastMetrics
בקשות שמפירות את המגבלות האלה נדחות עם השגיאה:
RESOURCE_EXHAUSTED
.QPS אחד מחושב כ-60 בקשות ל-60 שניות.
חשוב לזכור את המגבלות האלה כשיוצרים תוכנית למילות מפתח.
אובייקט של תוכנית מילות מפתח | מספר מקסימלי |
---|---|
KeywordPlan לחשבון |
10,000 |
KeywordPlanAdGroup לכל KeywordPlan |
200 |
KeywordPlanAdGroupKeyword לכל KeywordPlan |
10,000 |
KeywordPlanCampaignKeyword (מילות מפתח שליליות) |
1,000 |
KeywordPlanCampaign לכל KeywordPlan |
1 |
שירות העלאת המרות
מוגבל ל-2,000 המרות מסוג שיחה או קליק לכל בקשה:
בקשות שמפרות את המגבלות האלה נדחות עם השגיאה:
TOO_MANY_CONVERSIONS_IN_REQUEST
.
שירות העלאה של התאמת המרות
מוגבל ל-2,000 שינויים של ערכי המרות לכל בקשה:
בקשות שמפרות את המגבלות האלה נדחות עם השגיאה:
TOO_MANY_ADJUSTMENTS_IN_REQUEST
.
שירותים לחיוב ולתקציב חשבון
ניתן לבצע שינויים רק בחשבונות שהוגדר בהם חיוב חודשי.
בקשות שמפרות את המגבלה הזו נדחות עם השגיאה:
MUTATE_NOT_ALLOWED
.רק פעולה 1 מותרת לבקשות לשינוי.
בקשות שמפרות את המגבלה הזו נדחות עם השגיאה:
TOO_MANY_MUTATE_OPERATIONS
.יש להמתין לפחות 12 שעות בין שינוי של סדר הקצאת התקציב באותו חשבון. ביצוע שינויים לפני שחלפו 12 שעות עלול לגרום לכשלים בלתי הפיכה, שרק איש הקשר האחראי לחשבון Google Ads יוכל לפתור.
הזמנות לחשבונות לקוח
אפשר להזמין משתמשים חדשים לחשבונות לקוח קיימים באמצעות CustomerUserAccessService
. מכיוון שהפונקציונליות הזו שולחת הזמנות באימייל למשתמשים אחרים, יש אפשרות לעשות בה שימוש לרעה, ולכן יש מגבלות על ההתנהגות שלה:
משתמשים לא יכולים לקבל יותר מהזמנה אחת בהמתנה לאותו חשבון לקוח. אם תוצג בקשה נוספת לשלוח הזמנה למשתמש שכבר יש לו הזמנה בהמתנה, תופיע הודעת השגיאה הבאה:
ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION
.בחשבונות לקוח לא יכולות להיות יותר מ-70 הזמנות בהמתנה בכל פעם. אם נשלחת בקשה שגורמת לחריגה מהערך הזה, השגיאה הבאה מוחזרת:
ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED
.
נתוני משתמשים
נתוני המשתמשים מנוהלים באמצעות UserDataService
ו-OfflineUserDataJobService
.
בפעולת יצירה/הסרה נתונה UserData
, כל קבוצה של user_identifiers
צריכה להיות ספציפית למשתמש אחד.
כדי לאכוף זאת, מוחזרת שגיאה מסוג OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS
או UserDataError.TOO_MANY_USER_IDENTIFIERS
כשיש יותר מ-20 user_identifiers
בקבוצה UserData
.
סוגים נוספים של מגבלות
שדה חוזר, כמו רשימת פעולות, שכולל יותר מדי פריטים בבקשה, עלול לגרום לשגיאה: REQUEST_SIZE_LIMIT_EXCEEDED
.
הודעת השגיאה הזו יכולה לנבוע גם מבעיות אחרות.
אם נתקלתם במגבלה הזו ואתם שולחים בקשות שמשתמשות בשדה חוזר, נסו לצמצם את מספר הפריטים בשדה החוזר על ידי פריסה של רשימת הפעולות בבקשת השינוי.
כשיוצרים שאילתת GAQL, מספר הפריטים המקסימלי בתוך תנאי IN
הוא 20,000. אם תחרגו מהמגבלה, תוחזר השגיאה FILTER_HAS_TOO_MANY_VALUES
.