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

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 קבוצות מודעות

שירות: 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.