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 קבוצות של מודעות שירות: SearchAds360Service
|
1 |
פעולה: SearchStream
ספירה: 45 קמפיינים שירות: SearchAds360Service
|
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.