خطاها و هشدارها

رابط برنامه‌نویسی کاربردی نمایشگر و ویدئو ۳۶۰ می‌تواند به تعدادی خطا و هشدار پاسخ دهد. یک راهکار API سالم باید این خطاها را مدیریت کند.

خطاهای API

درخواست‌های ارسالی به API که در انجام عمل مورد نظر ناموفق باشند، خطا برمی‌گردانند. پاسخ‌های خطا باید دریافت و مدیریت شوند.

هشدار: درخواست‌های دارای خطای برگشتی جزو سهمیه محاسبه می‌شوند. برای استفاده بهتر از سهمیه API خود، نرخ خطا را کاهش دهید.

یک پاسخ خطای API شامل یک کد پاسخ HTTP، یک پیام خطا و یک کد وضعیت Google RPC است و فرمت آن به صورت زیر است:

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

در زیر لیستی از خطاهای رایج API و اقدامات پیشنهادی آمده است:

توجه: اگر با وجود اقدامات انجام شده، خطا همچنان ادامه داشت، با پشتیبانی تماس بگیرید .

کدهای خطا
400	INVALID_ARGUMENT مشکلی در درخواست شما وجود دارد. فیلد پیام در پاسخ خطا را بررسی کرده و درخواست خود را بر اساس آن به‌روزرسانی کنید.
401	UNAUTHENTICATED درخواست شما به درستی احراز هویت نشد. تأیید کنید که اعتبارنامه‌های معتبر OAuth را در درخواست خود گنجانده‌اید. برای اطلاعات بیشتر، به راهنمای شروع سریع ما مراجعه کنید.
403	PERMISSION_DENIED شما مجوزهای لازم برای تکمیل درخواست را ندارید. تأیید کنید که حساب کاربری شما مجوزهای لازم برای شریک یا تبلیغ‌کننده مربوطه را دارد.
404	NOT_FOUND منبعی که می‌خواهید بازیابی کنید، یافت نشد. تأیید کنید که شناسه‌ای که استفاده می‌کنید صحیح است و با نوع منبعی که بازیابی می‌شود، مطابقت دارد.
409	ABORTED منبعی که می‌خواهید تغییر دهید در جای دیگری در حال تغییر است. چند ثانیه صبر کنید و سپس درخواست را دوباره امتحان کنید.
429	RESOURCE_EXHAUSTED شما از محدودیت نرخ یا سهمیه درخواست روزانه خود فراتر رفته‌اید. از کنسول Google Cloud برای بررسی میزان استفاده از API خود استفاده کنید. گردش کار خود را به‌روزرسانی کنید تا در محدوده سهمیه موجود عمل کنید. برای اطلاعات بیشتر، به راهنمای ما در مورد بهینه‌سازی استفاده مراجعه کنید.
500	INTERNAL API با خطای داخلی مواجه شد. چند ثانیه صبر کنید و سپس درخواست را دوباره امتحان کنید. اگر خطا ادامه داشت، با پشتیبانی تماس بگیرید .
504	DEADLINE_EXCEEDED تکمیل درخواست توسط API بیش از حد طول کشید. چند ثانیه صبر کنید و سپس درخواست را دوباره امتحان کنید. اگر خطا ادامه داشت، با پشتیبانی تماس بگیرید .

خطاهای SDF

رابط برنامه‌نویسی کاربردی Display & Video 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 دریافت کنید. اگر یک آیتم خطی هشدار غیرمنتظره‌ای را برگرداند، در اسرع وقت به مشکل رسیدگی کنید تا تأثیر آن بر ارائه کاهش یابد.

حتی اگر تنظیمات یا هدف‌گذاری تغییر نکرده باشد، می‌توان هشدارها را اضافه کرد. نمونه‌هایی از این موارد عبارتند از:

• دستور درج متوقف شده یا منقضی شده است.
• گزینه فهرست کاربران یا هدف‌گیری منسوخ شده است.