الأخطاء الشائعة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توضّح هذه الصفحة الأخطاء الأكثر شيوعًا التي تعرضها واجهة برمجة تطبيقات "مدير إعلانات Google". يتم عرض الأخطاء بالتنسيق
Error.REASON:
EntityChildrenLimitReachedError
- ملخّص
- تم الوصول إلى الحد الأقصى لعدد العناصر الثانوية المسموح بها في الكيان
ولا يمكن إضافة المزيد من العناصر الثانوية إلى هذا الكيان.
- نصائح يُنصح بها للتعامل مع الجهاز
- يمكنك إنشاء نوع جديد من الكيان الذي وصل إلى الحدّ الأقصى المسموح به لعدد
العناصر الفرعية وإضافة الكيان الفرعي الذي تحاول إنشاءه إلى الكيان الجديد.
على سبيل المثال، إذا استلمت LINE_ITEM_LIMIT_FOR_ORDER_REACHED، عليك إنشاء طلب جديد وإضافة العنصر الذي تحاول إنشاءه إلى ذلك الطلب الجديد.
QuotaError.EXCEEDED_QUOTA
- ملخّص
- عدد الطلبات المقدمة في الثانية كبير جدًا وقد تجاوز
الحد المسموح به.
- نصائح يُنصح بها للتعامل مع الجهاز
-
- استخدِم الطرق المجمّعة مثل updateLineItems من خلال جمع التغييرات محليًا وتقديم طلب واحد لتنفيذ هذه التغييرات دُفعة واحدة.
- يُرجى الانتظار 5 ثوانٍ تقريبًا ثم إعادة محاولة الطلب. يُرجى العِلم بأنّ ذلك
لا يضمن نجاح الطلب. وإذا تعذّر ذلك مرة أخرى، حاوِل زيادة
وقت الانتظار. ننصح بذلك للتطبيقات التفاعلية المدمجة مع "مدير الإعلانات" والتي يتم استخدامها في الوقت الفعلي.
- ويمكنك تقييد الطلبات بمرتين في الثانية لشبكات "مدير الإعلانات"، أو 8 في الثانية لشبكات "مدير الإعلانات 360". ومرة أخرى، لا يضمن ذلك
نجاح كل طلب، لكنّه قد يساعد في تقليل عدد مرات تلقّي
هذا الخطأ. ننصح باستخدام هذا الإجراء للتطبيقات التي تتكامل مع "مدير الإعلانات"
والتي لا تتفاعل في الوقت الفعلي، مثل إعداد التقارير الليلية.
AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK
- ملخّص
- حاول المستخدم إنشاء شبكة اختبار باستخدام حساب مرتبط بالفعل بشبكة.
- الأسباب الشائعة
- لم ينشئ المستخدم حسابًا جديدًا على Google أولاً قبل الاتصال بـ
NetworkService.makeTestNetwork().
- نصائح يُنصح بها للتعامل مع الجهاز
- عليك إنشاء حساب جديد تمامًا قبل الاتصال بـ
NetworkService.makeTestNetwork(). اطّلِع على كيفية إنشاء شبكة اختبار للحصول على مزيد من المعلومات.
AuthenticationError.NETWORK_CODE_REQUIRED
- ملخّص
- لم يقدّم المستخدم
networkCode. لتقديم الطلب، يجب إدخال رمز شبكة.
- الأسباب الشائعة
- يجب استخدام رموز الشبكة لجميع الطلبات باستثناء
NetworkService.getAllNetworks()
وNetworkService.makeTestNetwork().
- نصائح يُنصح بها للتعامل مع الجهاز
- يُرجى تضمين رمز الشبكة التي تتم معالجتها في عنوان الطلب. لا تستخدم سوى رمز الشبكة المتاح لتسجيل الدخول إلى حسابك. يمكنك العثور على الرمز على الموقع الإلكتروني الخاص بـ "مدير الإعلانات" لحسابك، وذلك في صفحة المشرف > إعدادات الشبكة بجانب "رمز الشبكة". يمكن العثور على مزيد من المعلومات حول إعداد رمز الشبكة في صفحة طلبات ملف XML الخاص بـ SOAP وعناوين الاستجابة.
AuthenticationError.NETWORK_NOT_FOUND
- ملخّص
- تعذّر تقديم الطلب لأنّ رمز الشبكة المقدَّم في الإعدادات غير متوفّر على الخادم.
- الأسباب الشائعة
- لقد حددت رمز شبكة غير صحيح في التهيئة.
- نصائح يُنصح بها للتعامل مع الجهاز
- سيقترح حقل "المشغل" في سجلّ الأخطاء غالبًا الشبكة الصحيحة
للمستخدم.
AuthenticationError.NO_NETWORKS_TO_ACCESS
- ملخّص
- المستخدم غير مرتبط بأي شبكة.
- الأسباب الشائعة
- لم يتم تفعيل حساب الإنتاج للوصول إلى واجهة برمجة التطبيقات.
- نصائح يُنصح بها للتعامل مع الجهاز
- فعِّل إمكانية الوصول إلى واجهة برمجة التطبيقات في بيئة الإنتاج. راجع تفعيل الوصول إلى واجهة برمجة التطبيقات للحصول على معلومات.
AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS
- ملخّص
- العميل غير مُدرَج في القائمة البيضاء للوصول إلى واجهة برمجة التطبيقات.
- الأسباب الشائعة
- شبكتك ليست في القائمة البيضاء للإنتاج، ولكنك قدّمت رمز شبكة في عنوان SOAP.
-
- نصائح يُنصح بها للتعامل مع الجهاز
- فعِّل الوصول إلى واجهة برمجة التطبيقات.
-
PermissionError.PERMISSION_DENIED
- ملخّص
- لا يملك المستخدم الإذن المطلوب لتنفيذ الطلب.
- الأسباب الشائعة
-
- لقد حاولت الوصول إلى عنصر موجود في شبكة أخرى.
- لقد حاولت الوصول إلى عنصر متوفِّر في شبكتك،
ولكن ليس لديك إذن بالقراءة أو التعديل.
- لقد حاولت تنفيذ مهمة تتطلب ميزة إضافية
ليتم تفعيلها في حسابك.
- نصائح يُنصح بها للتعامل مع الجهاز
-
- إذا كنت ستنشئ واجهة مستخدم، أبلِغ المستخدم بأنّه لم يكن لديه الإذن اللازم لتنفيذ هذا الإجراء والتحدّث إلى مشرفه.
- إذا حاولت تنفيذ مهمة، مثل إحدى المهام التي تتضمن ميزة مدفوعة فقط
لا يملك شبكتك إذنًا بتنفيذها، يمكنك التواصل مع
مدير حسابك بشأن تفعيل هذه الميزة.
- تذكَّر أنّ شبكات الاختبار هي ليست شبكات "مدير إعلانات Google 360"، ما يعني أنّها لا تتضمّن الميزات المدفوعة المتوفّرة في شبكات "مدير إعلانات Google 360". تواصَل مع مدير حسابك لتفعيل الميزات على
شبكة الاختبار.
ApiVersionError.UPDATE_TO_NEWER_VERSION
- ملخّص
- لقد قدَّم التطبيق إما طلبًا يتطلب استخدام إصدار أحدث
لنجاحه، أو أرسل طلبًا إلى إصدار تم إيقافه نهائيًا.
- الأسباب الشائعة
-
- تم إيقاف إصدار طلب البيانات من واجهة برمجة التطبيقات. يُرجى الاشتراك في مدوّنتنا لتلقّي إشعارات عن الإيقاف النهائي.
- يتطلب نجاح الطلب الذي قدمته إصدارًا أحدث من واجهة برمجة التطبيقات.
وغالبًا ما يتم تقديم ميزة في واجهة المستخدم. لكي ترسل واجهة برمجة التطبيقات العنصر بشكل صحيح، تحتاج واجهة برمجة التطبيقات إلى إصدار أحدث.
- نصائح يُنصح بها للتعامل مع الجهاز
-
- يمكنك الاطّلاع على آخر إصدارات واجهة برمجة التطبيقات، والتخطيط للترقية بشكل منتظم.
- اشترِك في مدوّنتنا لتلقّي إشعارات بشأن عمليات الإيقاف النهائي.
خطأ 404
- ملخّص
- لم يصل طلبك إلى الخادم.
- الأسباب الشائعة
- ربما تم إعداد اتصال الإنترنت أو الخادم الوكيل بشكلٍ خاطئ. وقد يتم أيضًا إيقاف إصدار واجهة برمجة التطبيقات الذي تطلبه.
-
- نصائح يُنصح بها للتعامل مع الجهاز
- تحقَّق من إعداد الإنترنت أو الخادم الوكيل وتأكّد من أنّك تستخدم
إصدارًا حديثًا من واجهة برمجة التطبيقات. وقد تحتاج إلى ترقية مكتبة البرامج إلى أحدث إصدار أيضًا.
-
- نصائح للوقاية من الفيروس
- يمكنك الاشتراك في منتدى واجهة برمجة تطبيقات "مدير الإعلانات" والاطّلاع على مدونتنا للاطّلاع على آخر أخبار واجهة برمجة تطبيقات "مدير الإعلانات".
خطأ إلغاء تنظيم
- ملخّص
- لم يتوافق ملف SOAP XML في طلبك مع مواصفات WSDL.
- الأسباب الشائعة
- يحتوي الطلب على حقول أو كيانات غير مضمّنة في مواصفات WSDL
أو في مساحة اسم غير صحيحة.
-
- هناك عدم تطابق في النوع في الطلب (مثلاً، يحتوي حقل عدد صحيح على قيمة سلسلة).
-
- نصائح يُنصح بها للتعامل مع الجهاز
- تأكَّد من توافق طلبك مع مواصفات WSDL.
-
- استخدِم مكتبة برامج لإنشاء
بروتوكول SOAP صالح، واستخدِمها للمقارنة. وتتيح جميع مكتبات العملاء إمكانية تسجيل طلبات SOAP واستجاباتها.
-
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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:"]]
