תמחור, מגבלות API ומכסות

ב-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.