يمكن أن تردّ واجهة برمجة التطبيقات في "مساحة العرض والفيديو 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 Cloud لفحص استخدامك لواجهة برمجة التطبيقات. عدِّل سير العمل ليعمل ضمن حدود الحصة الحالية. لمزيد من المعلومات، يُرجى الاطّلاع على دليلنا حول تحسين الاستخدام. |
500 |
INTERNALحدث خطأ داخلي في واجهة برمجة التطبيقات. انتظِر بضع ثوانٍ ثم أعِد محاولة إجراء الطلب. في حال استمرار ظهور الخطأ، يُرجى التواصل مع فريق الدعم. |
504 |
DEADLINE_EXCEEDEDاستغرقت واجهة برمجة التطبيقات وقتًا طويلاً جدًا لإكمال الطلب. انتظِر بضع ثوانٍ ثم أعِد محاولة إجراء الطلب. في حال استمرار ظهور الخطأ، يُرجى التواصل مع فريق الدعم. |
أخطاء SDF
تستخدِم واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360" مهامًا تستغرق وقتًا طويلاً لإنشاء ملفات البيانات المنظَّمة (SDF). يتم عرض الأخطاء التي تحدث أثناء إنشاء ملفات SDF في operation المكتمل. سيتضمّن الحقل error التفاصيل.
إليك مثالاً مختصرًا:
{
...
"done": true,
"error": {
"code": 3,
"message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
}
}
إذا لم تكن رسالة الخطأ واضحة، ننصحك بما يلي:
- تأكَّد من أنّ المستخدم لديه دور مستخدم عادي على الأقل لشريك أو معلن العنصر الرئيسي.
- تأكَّد من أنّ أرقام التعريف المقدَّمة في الفلتر دقيقة. يجب أن تتوافق أرقام التعريف مع نوع المورد المقصود، ويجب أن تكون موارد فرعية من المعرّف الجذر.
- تأكَّد من أنّ المستخدم لديه أقل من عشرين مهمة تنزيل متزامنة لملفات SDF.
في حال استمرار ظهور الأخطاء، يُرجى التواصل مع فريق الدعم.
التحذيرات غير المُسبِّبة للحظر
تشير التحذيرات غير الحظر إلى مشكلة قد تؤثر في عرض إعلانات أحد عناصر الحملة. تظهر تحذيرات مشابهة في واجهة المستخدم. هذه التحذيرات سلبية ويتم إدراجها في البند الإعلاني.
يمكن أن يؤثر السبب الأساسي للتحذير في عرض بند إعلاني. وفي بعض الحالات، قد يؤدي ذلك إلى منع عرض الإعلانات تمامًا.
الوقاية
تحدث بعض التحذيرات غير الحظرية بسبب إعداد البند الإعلاني بشكل غير صحيح:
- مدة العرض: لن يعرض البند الإعلاني الإعلانات إذا كانت مدة العرض غير صالحة أو إذا انتهت صلاحية مدة العرض في طلب الإدراج. تأكَّد من أنّ البند الإعلاني يتضمّن فترة عرض ضمن فترة طلب الإدراج.
- تصاميم الإعلانات المعيّنة: لا يمكن عرض بند إعلان إذا لم يتم تعيين تصميم إعلان صالح له.
- الاستهداف: قد يتأثّر عرض إعلان أحد عناصر الحملة أو يتم منعه تمامًا إذا لم يتم تحديد الاستهداف بشكلٍ صحيح.
تأكَّد من أنّ البند الحالي لا يعرض أي تحذيرات قبل استخدام إعداداته في بند جديد.
التتبّع
يمكن أن تظهر تحذيرات غير حاسمة أثناء عرض البند الإعلاني. راقِب عناصر حملتك النشطة بحثًا عن تحذيرات جديدة للتأكّد من أنّها تعرض الإعلانات بشكلٍ صحيح.
يمكنك الحصول على بنود إعلانية مجمّعة باستخدام طلب list. إذا عرض بند إعلان تحذيرًا غير متوقّع، عليك معالجة المشكلة في أقرب وقت ممكن للحدّ من تأثيرها في العرض.
يمكن إضافة تحذيرات حتى إذا لم تتغير الإعدادات أو الاستهداف. ومن الأمثلة على ذلك:
- تم إيقاف طلب الإدراج مؤقتًا أو انتهت صلاحيته.
- تم إيقاف قائمة مستخدمين أو خيار استهداف نهائيًا.