שגיאות נפוצות
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדף זה מתוארות השגיאות הנפוצות ביותר שהוחזרו על ידי 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.
-
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-21 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-21 (שעון UTC)."],[[["\u003cp\u003eThis page lists common Google Ad Manager API errors and offers troubleshooting tips.\u003c/p\u003e\n"],["\u003cp\u003eErrors are categorized by type, such as authentication, permission, and quota errors.\u003c/p\u003e\n"],["\u003cp\u003eEach error description includes a summary, common causes, and recommended handling tips.\u003c/p\u003e\n"],["\u003cp\u003eUsers are encouraged to stay updated on API versions and subscribe to the Ad Manager API forum and blog for the latest news.\u003c/p\u003e\n"],["\u003cp\u003eUtilizing client libraries for generating valid SOAP requests is recommended to avoid unmarshalling errors.\u003c/p\u003e\n"]]],[],null,["# Common Errors\n\nThis page describes the most frequently encountered errors returned by the\nGoogle Ad Manager API. Errors are returned in the format\n`Error.REASON`:\n\n- [`EntityChildrenLimitReachedError`](#EntityChildrenLimitReachedError)\n- [`QuotaError.EXCEEDED_QUOTA`](#QuotaError.EXCEEDED_QUOTA)\n- [`AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK`](#AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK)\n- [`AuthenticationError.NETWORK_CODE_REQUIRED`](#AuthenticationError.NETWORK_CODE_REQUIRED)\n- [`AuthenticationError.NETWORK_NOT_FOUND`](#AuthenticationError.NETWORK_NOT_FOUND)\n- [`AuthenticationError.NO_NETWORKS_TO_ACCESS`](#AuthenticationError.NO_NETWORKS_TO_ACCESS)\n- [`AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS`](#AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS)\n- [`PermissionError.PERMISSION_DENIED`](#PermissionError.PERMISSION_DENIED)\n- [`ApiVersionError.UPDATE_TO_NEWER_VERSION`](#ApiVersionError.UPDATE_TO_NEWER_VERSION)\n- [404 Error](#404Error)\n- [Unmarshalling Errors](#Unmarshalling)\n\n[Entity limit errors](/ad-manager/api/reference/latest/LineItemService.EntityChildrenLimitReachedError)\n-------------------------------------------------------------------------------------------------------\n\n### `EntityChildrenLimitReachedError`\n\nSummary\n: The maximum number of allowed children has been reached for the entity\n and no more children can be added to that entity.\n\nRecommended handling tips\n: Create a new type of the entity that has reached the max allowed number\n of children and add the child entity you are trying to create to the new one.\n For example if you receive [LINE_ITEM_LIMIT_FOR_ORDER_REACHED](/ad-manager/api/reference/latest/LineItemService.EntityChildrenLimitReachedError.Reason#LINE_ITEM_LIMIT_FOR_ORDER_REACHED),\n then you will need to create a new order and add the line item you are trying\n to create to that new order.\n\n[Quota errors](/ad-manager/api/reference/latest/NetworkService.QuotaError)\n--------------------------------------------------------------------------\n\n### `QuotaError.EXCEEDED_QUOTA`\n\nSummary\n: The number of requests made per second is too high and has exceeded the\n allowable limit.\n\nRecommended handling tips\n:\n - Use batch methods such as [updateLineItems](/ad-manager/api/reference/latest/LineItemService#updateLineItems) by gathering changes locally and making a single request to fulfill those changes all at once.\n - Wait about 5 seconds and then retry the request. Note that this does not guarantee the request will succeed. If it fails again, try increasing the wait time. This is recommended for interactive applications integrating with Ad Manager that are used in real time.\n - Limit requests to 2 per second for Ad Manager networks, or 8 per second for Ad Manager 360 networks. Once again this does not guarantee that every request will succeed, but may help reduce the number of times you receive this error. This is recommended for applications integrating with Ad Manager that do not have real time interaction, such as running nightly reports.\n\n[Authentication errors](/ad-manager/api/reference/latest/NetworkService.AuthenticationError)\n--------------------------------------------------------------------------------------------\n\n### `AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK`\n\nSummary\n: The user tried to create a test network using an account that already is\n associated with a network.\n\nCommon causes\n: The user did not create a new Google account first before calling\n `NetworkService.makeTestNetwork()`.\n\nRecommended handling tips\n: Create a brand new account before calling\n `NetworkService.makeTestNetwork()`. See [how to create a test network](/ad-manager/api/start#enable_api) for more\n information.\n\n### `AuthenticationError.NETWORK_CODE_REQUIRED`\n\nSummary\n: The user did not provide a `networkCode`. To make the request,\n a network code is required.\n\nCommon causes\n: Network codes are required for all requests except\n `NetworkService.getAllNetworks()` and\n `NetworkService.makeTestNetwork()`.\n\nRecommended handling tips\n: Include the network code of the network being addressed in the request\n header. Only use a network code available to your account login. You can find\n the code on the Ad Manager website for your account, on the Admin \\\u003e Network\n Settings page next to \"Network code\". More information about setting your\n network code can be found on the [SOAP XML request and\n response headers](/ad-manager/api/soap_xml) page.\n\n### `AuthenticationError.NETWORK_NOT_FOUND`\n\nSummary\n: The request could not be made because the network code provided in the\n configuration is not found on the server.\n\nCommon causes\n: You have specified an incorrect network code in your configuration.\n\nRecommended handling tips\n: The \"trigger\" field of the error log will often suggest the correct\n network for the user.\n\n### `AuthenticationError.NO_NETWORKS_TO_ACCESS`\n\nSummary\n: The user is not associated with any network.\n\nCommon causes\n: You have not enabled your production account for API access.\n\nRecommended handling tips\n: Enable API access to your production environment. See [Enabling API Access](/ad-manager/api/start#enable_api) for information.\n\n### `AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS`\n\nSummary\n: The customer is not whitelisted for API access.\n\nCommon causes\n: Your network is not whitelisted for production, but you provided a [network code](/ad-manager/api/soap_xml) in the SOAP Header.\n:\n\nRecommended handling tips\n: Enable [API access](/ad-manager/api/start#enable_api).\n:\n\n[Permission errors](/ad-manager/api/reference/latest/NetworkService.PermissionError)\n------------------------------------------------------------------------------------\n\n### `PermissionError.PERMISSION_DENIED`\n\nSummary\n: The user does not have the required permission for the request.\n\nCommon causes\n:\n - You tried to access an object that exists in another network.\n - You tried to access an object that exists in your network, but you don't have permission to read or update.\n - You tried to perform a task that requires an additional feature to enabled on your account.\n\nRecommended handling tips\n:\n - If you are creating a UI, indicate to the user that they did not have permission to perform this action and to speak to their Administrator.\n - If you tried performing a task, such as one involving a premium-only feature that your network does not have permission to do, speak to your account manager about enabling this feature.\n - Remember, test networks are, by default, not Ad Manager 360 networks, meaning that they do not have the premium features found in Ad Manager 360 networks. Speak to your account manager to enable features on your test network.\n\n[Version errors](/ad-manager/api/reference/latest/NetworkService.ApiVersionError)\n---------------------------------------------------------------------------------\n\n### `ApiVersionError.UPDATE_TO_NEWER_VERSION`\n\nSummary\n: The application either: initiated a request that requires a newer version\n to succeed; or initiated a request to a deprecated version.\n\nCommon causes\n:\n - The version of the API call has been deprecated. Please subscribe to our [blog](//ads-developers.googleblog.com/search/label/ad_manager_api) for deprecation announcements.\n - The request you made requires a newer version of the API to succeed. This is often the case where a feature has been introduced in the UI and in order for the API to send the object correctly, it needs a newer version of the API.\n\nRecommended handling tips\n:\n - Stay up to date on API versions; plan on upgrading regularly.\n - Subscribe to our [blog](//ads-developers.googleblog.com/search/label/ad_manager_api) to be notified about deprecations.\n\n404 Error\n---------\n\nSummary\n: Your request did not reach the server.\n\nCommon causes\n: Your internet connection or proxy may be misconfigured. The version of\n the API you are calling may also be sunsetted.\n:\n\nRecommended handling tips\n: Check your internet or proxy configuration and make sure you are using a\n recent version of the API. You may want to upgrade your client library to\n the most recent version as well.\n:\n\nPrevention tips\n: Subscribe to the [Ad\n Manager API forum](//groups.google.com/group/google-doubleclick-for-publishers-api) and check our [blog](//ads-developers.googleblog.com/search/label/ad_manager_api)\n to stay updated on the latest Ad Manager API news.\n\nUnmarshalling Error\n-------------------\n\nSummary\n: The SOAP XML in your request did not conform to the WSDL\n specification.\n\nCommon causes\n: The request contains fields or entities not included in the WSDL\n specification, or in the wrong namespace.\n:\n: There is a type mismatch in the request (e.g., an integer field has a\n string value).\n:\n\nRecommended handling tips\n: Ensure that your request conforms to the WSDL specification.\n:\n: Use a [client library](/ad-manager/api/clients) to generate\n valid SOAP, and use this for comparison. All client libraries support\n logging of SOAP requests and responses.\n:"]]
