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

توضّح هذه الصفحة الأخطاء الأكثر شيوعًا التي تعرضها واجهة برمجة التطبيقات 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 وردودها.