אם בקשה ל-Search Ads 360 API מצליחה, ה-API מחזיר קוד סטטוס HTTP 200 יחד עם הנתונים המבוקשים בגוף התשובה.
אם לא ניתן לאמת בקשה, ה-API מחזיר קוד סטטוס HTTP בין 400 ל-499 יחד עם תיאור של שגיאת האימות.
אם שולחים בקשה חוקית מסוג Report.get() אבל מערכת Search Ads 360 לא מצליחה ליצור דוח, ה-API מחזיר אחד מקודי הסטטוס של HTTP שמפורטים בהמשך.
| קוד | סיבה | תיאור | הפעולה המומלצת |
|---|---|---|---|
410 |
reportUnavailableRequestTooLarge |
המערכת לא מעבדת יותר את הדוח כי הוא גדול מדי. |
במקום זאת, כדאי לבקש כמה דוחות קטנים יותר. לדוגמה, אפשר לפצל דוח של מפרסם אחד לכמה דוחות של חשבונות מנוע חיפוש. או לפצל דוח שנתי ל-12 דוחות חודשיים. |
410 |
reportUnavailableRateLimitExceeded |
הדוח לא מעובד יותר כי נשלחו יותר מדי דוחות מהפרויקט של המפתח בפרק זמן קצר. |
חשוב לוודא שהלקוח לא שולח בקשות בתדירות גבוהה יותר מהתדירות הרצויה. אם הביצועים של הלקוח תקינים, פנו לתמיכת הלקוחות של Search Ads 360. יש לכלול את מזהה הפרויקט של המפתח, את הקוד ואת הסיבה מהשורה הזו בטבלה (ולא מהשורה שבהמשך). |
410 |
reportUnavailableQuotaExceeded |
הדוח לא מעובד יותר כי הפרויקט של המפתח ביקש יותר מדי נתונים היום. |
חשוב לוודא שהלקוח לא שולח בקשות גדולות יותר ממה שאתם רוצים. אפשר לעקוב אחרי השימוש במכסות במסוף Google Cloud. אם הביצועים של הלקוח עומדים בציפיות, תוכלו לפנות לתמיכת הלקוחות של Search Ads 360 ולבקש הגדלה של המכסה. צריך לכלול את מזהה הפרויקט של המפתח, את הקוד ואת הסיבה שצוינו בשורה הזו בטבלה (ולא בשורה שלמעלה). אפשר לעיין גם במאמר תמחור ומגבלות שימוש. |
410 |
reportUnavailableInternalServerError |
מערכת Search Ads 360 לא יכולה להציג או ליצור את הדוח מסיבה לא צפויה כלשהי. |
פונים לתמיכת הלקוחות של Search Ads 360. יש לכלול את מזהה הדוח. |
410 |
reportUnavailableRequestError |
למרות שהבקשה עברה אימות, מערכת Search Ads 360 לא יכולה ליצור את הדוח המבוקש כי הוא מכיל שילוב לא חוקי של עמודות, מסננים ופלחונים. |
פונים לתמיכת הלקוחות של Search Ads 360. יש לכלול את מזהה הדוח. |
400 |
unsupportedApiVersion |
הגרסה לא נתמכת. |
עוברים ל-Search Ads 360 Reporting API. |
לכל שאר סוגי השגיאות, ה-API מחזיר תגובות שגיאה רגילות.