Search Ads 360 Reporting API אוכף מגבלות על פעולות API כדי להבטיח ביצועים אופטימליים של המערכת לכל המשתמשים.
תמחור
השימוש ב-Search Ads 360 Reporting API כלול במחיר הכולל של Search Ads 360. אין עמלות נוספות על השימוש ב-API.
מגבלות של שאילתות
המגבלות הבאות חלות על פעולות של שאילתות שמבוצעות באמצעות השיטות Search או 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.