العرض تم إيقاف الإصدار الثاني من Video 360 API. استخدام الشاشة & الإصدار 3 من Video 360 API بدلاً من ذلك. للحصول على تعليمات حول نقل البيانات من الإصدار 2 إلى الإصدار 3، يُرجى الاطّلاع على دليل نقل البيانات.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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

تأخذ استجابة الخطأ التنسيق التالي وتتضمن رمز استجابة 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

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

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