Search Ads 360 Reporting API אוכף מגבלות על פעולות ה-API כדי להבטיח ביצועי מערכת אופטימליים לכל המשתמשים.
תמחור
השימוש ב-Search Ads 360 Reporting API כלול במחיר הכולל של Search Ads 360. אין עמלות נוספות לשימוש ב-API.
מגבלות שאילתות
המגבלות הבאות חלות על פעולות שאילתה שמבוצעות באמצעות השיטות 'חיפוש' או SearchStream.
- 3,000 שאילתות לדקה לכל פרויקט לכל משתמש
- 3,000 שאילתות לדקה לכל פרויקט
- 150,000 שאילתות ביום לכל פרויקט
מגבלות יומיות על פעולות API
מגבלות השימוש היומיות ב-API מבוססות על מספר פעולות ה-API שבוצעו בכל פרויקט ב-Google Cloud.
שאילתה או דוח בודדים נספרים כפעולה אחת, ללא קשר לתוצאות שמועברות דרך SearchAds360Service.SearchStream או משליחת בקשות ל-SearchAds360Service.Search.
מידע נוסף
בטבלה הבאה מובאות מספר דוגמאות להנהלת חשבונות:
| בקשת API | הפעולות נספרות למגבלה היומית |
|---|---|
פעולה: Search
מספר: 53 קבוצות של מודעות
שירות: |
1 |
פעולה: SearchStream
מספר: 45 קמפיינים
שירות: |
1 |
בקשות שמפרות את המגבלות האלה נדחות עם השגיאה: RESOURCE_EXHAUSTED.
בקשות חיפוש
בקשת Search או SearchStream נספרת כפעולה אחת במכסת הפעולות היומית של המשתמש. בקשת SearchStream אחת נספרת כפעולת API אחת, ללא קשר למספר האצוות.
מגבלות gRPC
בכל ספריות הלקוח של Search Ads 360 Reporting API נעשה שימוש ב-gRPC כדי ליצור בקשות ותגובות. כברירת מחדל, ל-gRPC יש הודעה בגודל 4MB.
התשובות לא יכולות לחרוג מהמגבלה הזו. לדוגמה, בקשת חיפוש שכוללת הרבה שדות עשויה ליצור תשובה שגדולה מ-4MB. כדי למנוע את המגבלה הזו, אפשר לצמצם את מספר השדות שנבחרו, להקטין את גודל הדף או להשתמש בסטרימינג.
בקשות שמפירות את המגבלה הזו לא ייצרו SearchAds360Error, אבל ייצרו שגיאת gRPC מסוג 429 Resource Exhausted. כאן אפשר למצוא רשימה של הודעות וקודי שגיאה של gRPC.
בקשות מחולקות לדפים
בקשות שעברו עימוד (לדוגמה, בקשות שמכילות ערך next_page_token חוקי) לא נספרות במכסת הפעולות היומית של משתמש.
עם זאת, בקשות עימוד שמכילות אסימון דף שתוקפו פג או לא תקין יגרמו לחריגה וייספרו כחלק ממכסת הפעולות היומית.
בקשות שעוברות עימוד, כמו בקשות לחיפוש, כפופות גם הן למגבלה Page size cannot exceed 10,000 rows ונדחות אם הן מפרות את המגבלה הזו עם השגיאה: INVALID_PAGE_SIZE.
למידע נוסף על עימוד, ראו חלוקה בין תוצאות.
בקשות שמחזירות חריגות ב-API
בקשות שנדחו עם SearchAds360Failure עדיין נכללות במכסת הפעולות היומית של המשתמש.
בקשות שנכשלו אבל לא מחזירות SearchAds360Failure, למשל משגיאה ברמת הרשת, לא ייכללו במכסת הפעולות היומית של המשתמש, כי הבקשות לעולם לא יגיעו לשירות. דוגמה לכך היא כשל בקישוריות רשת.
סוגים נוספים של מגבלות
שדה חוזר, כמו רשימת פעולות, שכולל יותר מדי פריטים בבקשה, עלול לגרום לשגיאה: REQUEST_SIZE_LIMIT_EXCEEDED.
הודעת השגיאה הזו יכולה לנבוע גם מבעיות אחרות.
כשיוצרים שאילתה בשפת השאילתות של Search Ads 360, מספר הפריטים המקסימלי בתוך סעיף IN הוא 20,000. אם תחרגו מהמגבלה, תוחזר השגיאה FILTER_HAS_TOO_MANY_VALUES.