الأخطاء والتحذيرات

تتناول هذه الصفحة الأنواع المختلفة من الأخطاء والتحذيرات التي قد تواجهها عند استخدام Display & Video 360 API.

أخطاء واجهة برمجة التطبيقات

تعرض الطلبات التي يتم إجراؤها على واجهة برمجة التطبيقات والتي لا يمكن إكمالها رسالة خطأ. يتم احتساب الطلبات التي تُعرِض أخطاء ضمن حصة المستخدم، وسيتم أخذها في الاعتبار عند مراجعة طلبات الحصول على حصة إضافية. يجب معالجة الردود المتعلّقة بالأخطاء والتحكّم فيها لتجنُّب حدوث أخطاء في المستقبل.

تتّبع استجابة الخطأ التنسيق التالي وتتضمّن رمز استجابة HTTP ورسالة خطأ وحالة رمز Google RPC:

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

في ما يلي قائمة بأخطاء واجهة برمجة التطبيقات الشائعة إلى جانب الإجراء المقترَح اتّخاذه في حال ظهورها:

الرمز متوسط عائد النقرة الإجراء المقترَح
400 INVALID_ARGUMENT هناك مشكلة في طلبك. راجِع حقل الرسالة في ردّ الخطأ وعدِّل طلبك وفقًا لذلك.
401 UNAUTHENTICATED تعذّر مصادقة طلبك بشكل صحيح. تأكَّد من تضمين بيانات اعتماد OAuth صالحة في طلبك. لمزيد من المعلومات حول هذا الموضوع، يُرجى الرجوع إلى دليل البدء.
403 PERMISSION_DENIED لا تملك الأذونات اللازمة لإكمال طلبك. تأكَّد من أنّ حساب المستخدم الخاص بك يتضمّن الأذونات المناسبة للشريك أو العميل المعنيّين.
404 NOT_FOUND تعذّر العثور على المورد الذي تحاول استرجاعه. تأكَّد من أنّ المعرّف الذي تستخدمه هو صحيح وأنّه يخصّ نوع المورد الذي يتم استرجاعه.
409 ABORTED يتم تعديل المورد الذي تحاول تعديله في مكان آخر. يُرجى الانتظار لبضع ثوانٍ ثم إعادة محاولة إجراء الطلب.
429 RESOURCE_EXHAUSTED تجاوزت المعدل المسموح به أو الحصة اليومية لطلبات البيانات. راجِع استخدام واجهة برمجة التطبيقات باستخدام وحدة تحكّم Google API وعدِّل سير العمل لكي يعمل ضمن حدود الحصة المفروضة حاليًا. لمزيد من المعلومات، يُرجى الاطّلاع على صفحتنا حول تحسين الحصة.
500 INTERNAL حدث خطأ داخلي في واجهة برمجة التطبيقات. يُرجى الانتظار لبضع ثوانٍ ثم إعادة محاولة إجراء الطلب. إذا استمر ظهور الخطأ، يُرجى التواصل مع فريق الدعم.
504 DEADLINE_EXCEEDED استغرقت واجهة برمجة التطبيقات وقتًا طويلاً لإكمال الطلب. يُرجى الانتظار لبضع ثوانٍ ثم إعادة محاولة إجراء الطلب. إذا استمر ظهور الخطأ، يُرجى التواصل مع فريق الدعم.

أخطاء SDF

تستخدِم واجهة برمجة التطبيقات Display & Video 360 API طريقة غير متزامنة لإنشاء ملفات البيانات المنظَّمة (SDF) وتنزيلها. لهذا السبب، يتم عرض الأخطاء التي تمّ طرحها أثناء إنشاء ملف SDF في مهمة تنزيل ملف SDF مكتملة. تتم تمييز مهمة تنزيل ملف SDF تنتهي بالرقم error على أنّها مكتملة، ولكنّها تحتوي على حقل خطأ مملوء بدلاً من اسم مورد وسائط في حقل response، كما هو موضّح في هذا المثال المقتطع:

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

إذا ظهرت لك رسالة خطأ قابلة للتنفيذ عند محاولة إنشاء ملفات SDF، عليك اتّباع التعليمات الواردة فيها وفقًا لذلك. إذا لم تكن رسالة الخطأ تتضمّن إجراءً واضحًا، ننصحك بالإجراءات التالية:

  • تأكَّد من أنّ المستخدِم لديه الأذونات المناسبة لموارد الوالد الشريك أو المعلِن.
  • تأكَّد من أنّ أرقام التعريف المقدَّمة في الفلتر دقيقة، وتتوافق مع نوع المورد المقصود، وتكون ضمن سياق معرّف الجذر المحدّد.
  • تأكَّد من عدم تجاوز الحدّ الأقصى لعدد عشرين مهمة تنزيل SDF متزامنة لكل مستخدم.

إذا استمر ظهور أخطاء، يُرجى التواصل مع فريق الدعم للإبلاغ عن مشكلتك.

التحذيرات غير المحظورة

يتمّ تخصيص التحذيرات غير المحظورة لعناصر العرض للإشارة إلى مشكلة قد تؤثّر في عرض عنصر العرض. يتم إرسال تحذيرات مشابهة في واجهة المستخدم من خلال بانر الإشعارات. هذه التحذيرات غير نشطة ويتم إدراجها في حقل warningMessages لعنصر السطر.

على الرغم من أنّ المشاكل التي تؤدي إلى ظهور هذه التحذيرات غير نشطة، إلا أنّها يمكن أن تؤثّر في عرض أحد العناصر إلى حدّ منعه بالكامل.

الوقاية

يمكن تجنُّب العديد من المشاكل التي تؤدي إلى ظهور تحذيرات غير مانعة من خلال الإعداد الصحيح لإعدادات العناصر، بما في ذلك ما يلي:

  • العرض: إذا كان العرض لعنصر معيّن غير صالح، أو إذا انتهت صلاحية العرض لطلب الإدراج الرئيسي، سيُنشئ العنصر تحذيرًا ولن يتم عرضه. لتجنّب المشكلة الأخيرة، تأكَّد من أنّ رحلة العنصر في السطر لا تنتهي بعد رحلة طلب إدراجه الرئيسي.
  • تصاميم الإعلانات المخصّصة: إذا لم يكن هناك تصميم إعلان صالح مخصّص لعنصر، سيُنشئ العنصر تحذيرًا ولن يتم عرضه.
  • الاستهداف: إذا لم يتم تحديد استهداف العنصر بحقّه بشكلٍ صحيح، قد يُصدر العنصر تحذيرًا وقد يؤثر ذلك في عرض الإعلانات أو يمنع عرضه تمامًا.

في حال كنت تُكرّر الإعدادات من عنصر حالي، تأكّد من أنّه لا يُنشئ العنصر الحالي أي تحذيرات غير متوقّعة.

التتبّع

قد تظهر المشاكل التي تؤدي إلى ظهور تحذيرات غير حظرية أثناء عرض تفاصيل الإعلان. لضمان عرض بيانات عناصرك الإعلانية بشكل صحيح، عليك مراقبة عناصرك الإعلانية النشطة بحثًا عن التحذيرات التي تم إنشاؤها حديثًا. يمكن استرداد العناصر بشكل مجمّع باستخدام الدالة advertisers.lineItems.list. إذا كان أحد العناصر يُنشئ تحذيرًا غير متوقّع، عليك معالجة المشكلة على الفور للحدّ من تأثيرها في العرض.

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