דף זה תורגם על ידי Cloud Translation API.

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

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

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

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

סוגים אחרים של בקשות

בקשה שאינה בקשה של Get, Mutate, Search או SearchStream נספר כפעולה אחת במסגרת מכסת הפעולות היומית של המשתמש.

דוגמאות לבקשות כאלה:

בקשות שמחזירות חריגים באמצעות ה-API

בקשות שנדחות עם GoogleAdsFailure עדיין ייחשבו כחלק מ מכסת הפעולות היומית של המשתמש.

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

שירותי תכנון

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

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

סקירה כללית

מגבלות מערכת