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

Google Ads API אוכף מגבלות על פעולות API, כמו מספר הפעולות שאפשר לשלוח בבקשת שינוי אחת. הטבלה שבהמשך מסכמת חלק מהשינויים על המגבלות והמכסות החשובות שצריך להכיר.

אזהרה: אין יותר תמיכה בשיטות קבלה. שימוש ב-searchStream או במקום זאת, search כדי לאחזר אובייקטים.

סוג הבקשה, הגבלה וקוד שגיאה
בקשות עם חלוקה לדפים	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, אבל הפעולה הזו תיצור שגיאה 429 Resource Exhausted ב-gRPC. אפשר לעיין ברשימה של קודי השגיאה ל-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, למשל, משגיאה ב- ברמת הרשת, לא ייחשבו כחלק ממכסת הפעולות היומית של המשתמש. כי הבקשות לעולם לא יגיעו לשירות. דוגמה לכך קישוריות הרשת נכשלה.

שירותי תכנון

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

• מוגבל לבקשה אחת לשנייה לכל CID:

  • KeywordPlanIdeaService.GenerateKeywordIdeas
  • KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics
  • KeywordPlanIdeaService.GenerateKeywordForecastMetrics

  בקשות שמפירות את המגבלות האלה נדחות עם השגיאה: RESOURCE_EXHAUSTED.

• 1 QPS מחושב כ-60 בקשות לכל 60 שניות.

• מוגבל ל-2 בקשות לשנייה לכל CID:

  • KeywordPlanIdeaService.GenerateAdGroupTheme

חשוב לזכור את המגבלות האלה כשיוצרים תוכנית לשימוש במילות מפתח.

אובייקט של תוכנית מילות מפתח	מספר מקסימלי
KeywordPlan לכל חשבון	10,000
KeywordPlanAdGroup לכל KeywordPlan	200
KeywordPlanAdGroupKeyword לכל KeywordPlan	10,000
KeywordPlanCampaignKeyword (מילות מפתח שליליות)	1,000
KeywordPlanCampaign לכל KeywordPlan	1

שירות העלאת המרות

• מוגבל ל-2,000 המרות מסוג שיחה או קליקים עם כל בקשה:

  • ConversionUploadService.UploadCallConversions
  • ConversionUploadService.UploadClickConversions

  בקשות שמפירות את המגבלות האלה נדחות עם השגיאה: TOO_MANY_CONVERSIONS_IN_REQUEST.

שירות העלאת שינויים בערכי המרות

• מוגבל ל-2,000 התאמות של ערכי המרות לכל בקשה:

  • ConversionAdjustmentUploadService.UploadConversionAdjustments

  בקשות שמפירות את המגבלות האלה נדחות עם השגיאה: 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 שחוזרת על עצמה שגיאה.