שגיאות נפוצות

בדף הזה מתוארות השגיאות הנפוצות ביותר שמתקבלות מ-Google Ad Manager API. השגיאות מוחזרות בפורמט Error.REASON:

שגיאות שקשורות למגבלות על ישויות

EntityChildrenLimitReachedError

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

שגיאות שקשורות למכסות

QuotaError.EXCEEDED_QUOTA

סיכום
מספר הבקשות לשנייה גבוה מדי וחורג מהמגבלה המותרת.
טיפים מומלצים לטיפול
  • משתמשים בשיטות של אצווה כמו updateLineItems כדי לאסוף שינויים באופן מקומי ולשלוח בקשה אחת כדי לבצע את כל השינויים האלה בבת אחת.
  • ממתינים כ-5 שניות ואז מנסים לשלוח שוב את הבקשה. חשוב לזכור שזה לא מבטיח שהבקשה תאושר. אם הפעולה נכשלת שוב, נסו להגדיל את זמן ההמתנה. מומלץ להשתמש בשיטה הזו באפליקציות אינטראקטיביות שמשולבות עם Ad Manager ומשמשות בזמן אמת.
  • מגבילים את הבקשות ל-2 לשנייה ברשתות Ad Manager, או ל-8 לשנייה ברשתות Ad Manager 360. גם במקרה הזה, לא מובטח שכל בקשה תצליח, אבל זה יכול לעזור לצמצם את מספר הפעמים שבהן תתקבל השגיאה הזו. מומלץ להשתמש בשיטה הזו באפליקציות שמשתלבות עם Ad Manager שאין בהן אינטראקציה בזמן אמת, כמו הפעלת דוחות ליליים.

שגיאות אימות

AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK

סיכום
המשתמש ניסה ליצור רשת לבדיקה באמצעות חשבון שכבר משויך לרשת.
גורמים נפוצים
המשתמש לא יצר חשבון Google חדש לפני שהפעיל את NetworkService.makeTestNetwork().
טיפים מומלצים לטיפול
צריך ליצור חשבון חדש לפני שקוראים ל-NetworkService.makeTestNetwork(). מידע נוסף זמין במאמר איך יוצרים רשת לבדיקה.

AuthenticationError.NETWORK_CODE_REQUIRED

סיכום
המשתמש לא סיפק networkCode. כדי לשלוח את הבקשה, צריך קוד רשת.
גורמים נפוצים
צריך לציין קודי רשת בכל הבקשות, חוץ מבקשות מסוג NetworkService.getAllNetworks() ו- NetworkService.makeTestNetwork().
טיפים מומלצים לטיפול
צריך לכלול את קוד הרשת של הרשת שאליה פונים בכותרת הבקשה. השתמשו רק בקוד רשת שזמין להתחברות לחשבון שלכם. אפשר למצוא את הקוד באתר Ad Manager של החשבון, בדף "ניהול" > "הגדרות רשת" לצד "קוד רשת". מידע נוסף על הגדרת קוד הרשת זמין בדף כותרות של בקשות ותגובות ב-SOAP XML.

AuthenticationError.NETWORK_NOT_FOUND

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

AuthenticationError.NO_NETWORKS_TO_ACCESS

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

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

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

שגיאות בהרשאות

PermissionError.PERMISSION_DENIED

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

שגיאות בגרסאות

ApiVersionError.UPDATE_TO_NEWER_VERSION

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

שגיאת 404

סיכום
הבקשה שלך לא הגיעה לשרת.
גורמים נפוצים
יכול להיות שהחיבור לאינטרנט או שרת ה-proxy לא מוגדרים נכון. יכול להיות שגם גרסת ה-API שאליו אתם שולחים קריאה תצא משימוש.
טיפים מומלצים לטיפול
צריך לבדוק את הגדרות האינטרנט או ה-proxy ולוודא שמשתמשים בגרסה עדכנית של ה-API. יכול להיות שתרצו גם לשדרג את ספריית הלקוח לגרסה העדכנית ביותר.
טיפים למניעה
כדאי לבדוק את עזרה מהקהילה של Ad Manager ואת הבלוג שלנו כדי להתעדכן בחדשות האחרונות לגבי Ad Manager API.

שגיאה בביטול המרשלינג

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