الأخطاء الشائعة

توضّح هذه الصفحة الأخطاء الأكثر شيوعًا التي تعرضها واجهة برمجة التطبيقات Google Ad Manager API. يتم عرض الأخطاء بالتنسيق Error.REASON:

أخطاء الحدّ الأقصى للكيانات

EntityChildrenLimitReachedError

ملخّص
تم بلوغ الحد الأقصى لعدد العناصر الفرعية المسموح بها للعنصر ولا يمكن إضافة المزيد من العناصر الفرعية إلى هذا العنصر.
نصائح مقترَحة للتعامل مع المشاكل
أنشئ نوعًا جديدًا من العنصر الذي بلغ الحد الأقصى المسموح به لعدد العناصر الفرعية، ثم أضِف العنصر الفرعي الذي تحاول إنشاءه إلى العنصر الجديد. على سبيل المثال، إذا تلقّيت الخطأ LINE_ITEM_LIMIT_FOR_ORDER_REACHED، عليك إنشاء طلب جديد وإضافة عنصر الحملة الذي تحاول إنشاءه إلى هذا الطلب الجديد.

أخطاء الحصة

QuotaError.EXCEEDED_QUOTA

ملخّص
عدد الطلبات التي تم إجراؤها في الثانية الواحدة مرتفع جدًا وتجاوز الحد المسموح به.
نصائح مقترَحة للتعامل مع المشاكل
  • استخدِم طرقًا مجمّعة، مثل updateLineItems، من خلال جمع التغييرات محليًا وإرسال طلب واحد لتنفيذ هذه التغييرات كلها في الوقت نفسه.
  • انتظِر لمدة 5 ثوانٍ تقريبًا، ثم أعِد محاولة إجراء الطلب. يُرجى العِلم أنّ هذا لا يضمن نجاح الطلب. إذا تعذّر ذلك مرة أخرى، حاوِل زيادة وقت الانتظار. ننصح باستخدام هذه الطريقة للتطبيقات التفاعلية التي تتكامل مع "إدارة إعلانات Google" ويتم استخدامها في الوقت الفعلي.
  • يجب ألا يتجاوز عدد الطلبات في الثانية الواحدة طلبَين لشبكات "إدارة إعلانات Google"، أو 8 طلبات لشبكات "إدارة إعلانات Google‏ 360". مرة أخرى، لا يضمن ذلك نجاح كل طلب، ولكنّه قد يساعد في تقليل عدد المرات التي يظهر فيها هذا الخطأ. ننصح باستخدام هذا النوع للتطبيقات التي تتكامل مع "مدير إعلانات Google" ولا تتضمّن تفاعلاً في الوقت الفعلي، مثل عرض التقارير الليلية.

أخطاء المصادقة

AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK

ملخّص
حاول المستخدم إنشاء شبكة اختبار باستخدام حساب مرتبط بشبكة حاليًا.
الأسباب الشائعة
لم ينشئ المستخدم حسابًا جديدًا على Google أولاً قبل طلب NetworkService.makeTestNetwork().
نصائح مقترَحة للتعامل مع المشاكل
أنشئ حسابًا جديدًا تمامًا قبل الاتصال NetworkService.makeTestNetwork(). لمزيد من المعلومات، يُرجى الاطّلاع على كيفية إنشاء شبكة اختبار.

AuthenticationError.NETWORK_CODE_REQUIRED

ملخّص
لم يقدّم المستخدم networkCode. لتقديم الطلب، يجب إدخال معرِّف الشبكة.
الأسباب الشائعة
يجب توفير رموز الشبكة لجميع الطلبات باستثناء NetworkService.getAllNetworks() و NetworkService.makeTestNetwork().
نصائح مقترَحة للتعامل معها
أدرِج معرِّف الشبكة التي يتم توجيه الطلب إليها في عنوان الطلب. استخدِم معرِّف شبكة متاحًا لتسجيل الدخول إلى حسابك فقط. يمكنك العثور على الرمز في الموقع الإلكتروني الخاص بحسابك على "إدارة الإعلانات"، وذلك في صفحة "المشرف" > "إعدادات الشبكة" بجانب "معرِّف الشبكة". يمكنك العثور على مزيد من المعلومات حول ضبط معرِّف الشبكة على صفحة عناوين طلب واستجابة SOAP XML.

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

ملخّص
لم يصل طلبك إلى الخادم.
الأسباب الشائعة
قد يكون اتصالك بالإنترنت أو الخادم الوكيل مضبوطًا بشكل خاطئ. قد يكون إصدار واجهة برمجة التطبيقات الذي تستخدمه متوقفًا نهائيًا.
نصائح مقترَحة للتعامل معها
تحقَّق من إعدادات الإنترنت أو الخادم الوكيل وتأكَّد من استخدام إصدار حديث من واجهة برمجة التطبيقات. ننصحك أيضًا بترقية مكتبة البرامج إلى أحدث إصدار.
نصائح للوقاية من الفيروس
يمكنك الاطّلاع على منتدى مساعدة "مدير إعلانات Google" ومدوّنتنا للبقاء على اطّلاع على آخر الأخبار حول واجهة برمجة التطبيقات في "مدير إعلانات Google".

خطأ في إلغاء التسلسل

ملخّص
لم يتوافق SOAP XML في طلبك مع مواصفات WSDL.
الأسباب الشائعة
يحتوي الطلب على حقول أو كيانات غير مضمّنة في مواصفات WSDL أو في مساحة الاسم الخاطئة.
هناك عدم تطابق في النوع في الطلب (مثلاً، يحتوي حقل عدد صحيح على قيمة سلسلة).
نصائح مقترَحة للتعامل معها
تأكَّد من أنّ طلبك يتوافق مع مواصفات WSDL.
استخدِم مكتبة عميل لإنشاء SOAP صالح، واستخدِم هذا SOAP للمقارنة. تتيح جميع مكتبات البرامج تسجيل طلبات SOAP وردودها.