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

בדף זה מתוארות השגיאות הנפוצות ביותר שהוחזרו על ידי 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

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

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 API.

שגיאה בביטול העיצוב

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