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

בדף הזה מתוארות השגיאות הנפוצות ביותר שמוחזרות על ידי 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(). NetworkService.getAllNetworks() NetworkService.makeTestNetwork()
טיפים מומלצים לטיפול
צריך לכלול את הקוד של הרשת של הרשת שאליה מופנית הבקשה בכותרת הבקשה. יש להשתמש רק בקוד של הרשת שזמין לכניסה לחשבון. אפשר למצוא את הקוד של הרשת באתר Ad Manager בחשבון שלכם, בדף 'הגדרות הרשת' בקטע 'אדמין', לצד 'הקוד של הרשת'. מידע נוסף על הגדרת הקוד של הרשת זמין בדף כותרות של בקשות ותשובות SOAP XML.

AuthenticationError.NETWORK_NOT_FOUND

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

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 API, מומלץ לעיין בקהילת העזרה של Ad Manager ובבלוג שלנו.

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

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