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

این صفحه انواع مختلف خطاها و هشدارهایی را که ممکن است هنگام استفاده از Display & Video 360 API با آنها مواجه شوید، مورد بحث قرار می دهد.

خطاهای API

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

یک پاسخ خطا فرمت زیر را دارد و شامل کد پاسخ HTTP، پیام خطا و وضعیت کد RPC Google است :

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

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

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

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

خطاهای SDF

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

حتی اگر تنظیمات یا هدف گذاری یک مورد خطی تغییر نکرده باشد، ممکن است مشکلاتی ایجاد شود. به عنوان مثال می توان به توقف یا منقضی شدن سفارش درج والد و منسوخ شدن لیست های کاربران یا سایر هدف گذاری ها اشاره کرد.