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

تشرح هذه الصفحة الأنواع المختلفة من الأخطاء والتحذيرات التي قد تواجهها عند استخدام واجهة برمجة التطبيقات "مساحة العرض والفيديو 360".

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

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

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

{
  "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

تستخدِم واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" طريقة غير متزامنة لإنشاء ملفات البيانات المنظَّمة (SDFs) وتنزيلها. لهذا السبب، يتم عرض الأخطاء التي تظهر أثناء إنشاء أداة 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. إذا كان أحد العناصر يتسبّب في ظهور تحذير غير متوقّع، عليك معالجة المشكلة فورًا للحدّ من تأثيرها على العرض.

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