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

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

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

EntityChildrenLimitReachedError

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

أخطاء الحصة

QuotaError.EXCEEDED_QUOTA

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

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

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" ومدوّنتنا للبقاء على اطّلاع بآخر الأخبار حول Ad Manager API.

خطأ في إلغاء تنظيم البيانات

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