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

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

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

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