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

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