הממשק הקודם של Search Ads 360 Reporting API יוצא משימוש ב-30 ביוני 2024. חשוב לדעת ש-Search Ads 360 Conversion API לא מושפע מכך, ונמשיך לתמוך בו. בכל פיתוח הדוחות החדש יש להשתמש ב-Search Ads 360 Reporting API החדש.

החל מאפריל 2024, תוחזר שגיאה שאינה נתמכתApiVersion בתגובה לבקשת דוח. ניתן למצוא פרטים נוספים כאן.

מומלץ מאוד להעביר את כל ההטמעות הקיימות של Search Ads 360 ל-API החדש. מידע נוסף זמין במדריך לתחילת העבודה ובמדריך להעברת נתונים של Search Ads 360 Reporting API.

דף זה תורגם על ידי Cloud Translation API.

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

תמחור

השימוש ב-Search Ads 360 API כלול במחיר הכולל של Search Ads 360. אין עמלות נוספות בגין השימוש ב-API.

מכסות

ב-Search Ads 360 API מוקצית מכסה יומית למספר הבקשות שפרויקט Google API יכול לשלוח. כשמגיעים למכסה, בקשות נוספות מחזירות שגיאה, וכל הלקוחות שאומתו באמצעות הפרויקט הזה צריכים לחכות ליום המחרת כדי לשלוח בקשות נוספות. המכסות היומיות מתאפסות בחצות, לפי שעון החוף המערבי של ארה"ב.

המכסות מאורגנות בשלוש קטגוריות נפרדות:

Reports.generate(): מספר הבקשות של Reports.generate() שאתם יכולים לשלוח.
Reports.request(): מספר הבקשות ל-Reports.request() שאפשר לשלוח. המספר הזה משתנה בהתאם למשך הזמן הנדרש לחישוב כדי להפיק את הדוחות. לדוגמה, אפשר לבקש הרבה דוחות קטנים ופשוטים, או פחות דוחות גדולים ומורכבים.
ברירת מחדל: מספר הבקשות שאפשר לשלוח כדי לערוך סקר לגבי סטטוס של דוחות, להוריד דוחות וליצור רשימה והעלאה של המרות.

חשוב לשים לב: אי אפשר לשאול מקטגוריה אחת כדי להגדיל את המכסה בקטגוריה אחרת.

הצגה של נתוני השימוש והמכסות

כדי לראות את השימוש הנוכחי ולהשוות אותו למכסות היומיות:

נכנסים אל Google API Console באמצעות חשבון Google ששימש ליצירת פרטי הכניסה.
נכנסים לדף Enabled APIs של ספריית ה-API ב-API Console ובוחרים את Search Ads 360 API מהרשימה.
לוחצים על הכרטיסייה Quotas. בכרטיסייה Quotas מוצגים השימוש והמגבלות בפרויקט ה-API. כברירת מחדל, המגבלות מוגדרות למספר הבקשות זהה למספר הבקשות של הפרויקט. אפשר להקטין את המגבלות כדי שהמשתמשים לא יוכלו לנצל את כל המכסה של הפרויקט. המגבלות מיועדות בעיקר לפרויקטים שניתנים לחיוב או לפרויקטים עם מספר גדול של משתמשים. מכיוון שלא ניתן לחייב את Search Ads 360 API ובדרך כלל אין הרבה משתמשים בו, מומלץ להשאיר את הגדרת ברירת המחדל.
כדי לבדוק אם מישהו הגדיר מגבלה שנמוכה מהמכסה, לוחצים על סמל העריכה ליד סוג השאילתה. יופיע חלון קופץ שבו תוצג המכסה. לדוגמה, אם לוחצים על סמל העריכה שלצד Report שאילתות יצירת ביום, מופיע חלון קופץ עם טקסט כמו "הזנת מספר בין 1 ל-10,000". במקרה הזה, 10,000 הוא המכסה של הפרויקט לשאילתות של יצירת דוחות.

בקשה למכסה נוספת

אם הבקשה מחזירה שגיאה שמציינת שחרגת מהמכסה, קודם צריך לעיין במגבלות השימוש ובמגבלות כדי לוודא שלא חרגתם מהמגבלה. אם כבר הגדרתם מגבלות למכסה המקסימלית, תוכלו לפנות לתמיכה ולבקש מכסה נוספת.