اشتباهات رایج

این صفحه رایج‌ترین خطاهایی را که Google Ad Manager API برمی‌گرداند شرح می‌دهد. خطاها در قالب Error.REASON برگردانده می‌شوند:

خطاهای حد نهاد

EntityChildrenLimitReachedError

خلاصه
به حداکثر تعداد مجاز فرزندان برای این نهاد رسیده‌اید و فرزند دیگری نمی‌توان به این نهاد اضافه کرد.
نکات توصیه‌شده برای جابه‌جایی
نوع جدیدی از نهاد را که به حداکثر تعداد مجاز فرزندان رسیده است ایجاد کنید و نهاد فرزندی را که می‌خواهید ایجاد کنید به نهاد جدید اضافه کنید. برای مثال، اگر LINE_ITEM_LIMIT_FOR_ORDER_REACHED را دریافت کردید، باید سفارش جدیدی ایجاد کنید و ردیف هدف را که می‌خواهید ایجاد کنید به آن سفارش جدید اضافه کنید.

خطاهای سهمیه

QuotaError.EXCEEDED_QUOTA

خلاصه
تعداد درخواست‌های انجام‌شده در ثانیه بسیار زیاد است و از حد مجاز فراتر رفته است.
نکات توصیه‌شده برای جابه‌جایی
  • از روش‌های دسته‌ای مانند updateLineItems استفاده کنید با جمع‌آوری تغییرات به‌صورت محلی و ارسال یک درخواست واحد برای اعمال همه آن تغییرات به‌طور هم‌زمان.
  • حدود ۵ ثانیه صبر کنید و سپس درخواست را دوباره امتحان کنید. توجه داشته باشید که این کار تضمین نمی‌کند که درخواست موفقیت‌آمیز باشد. اگر دوباره ناموفق بود، زمان انتظار را افزایش دهید. این روش برای برنامه‌های تعاملی که با Ad Manager ادغام می‌شوند و به‌طور هم‌زمان استفاده می‌شوند توصیه می‌شود.
  • درخواست‌ها را به ۲ درخواست در ثانیه برای شبکه‌های Ad Manager، یا ۸ درخواست در ثانیه برای شبکه‌های Ad Manager 360 محدود کنید. بازهم این کار تضمین نمی‌کند که همه درخواست‌ها موفقیت‌آمیز باشند، اما ممکن است به کاهش تعداد دفعاتی که این خطا را دریافت می‌کنید کمک کند. این روش برای برنامه‌هایی توصیه می‌شود که با Ad Manager ادغام می‌شوند و تعامل هم‌زمان ندارند، مانند اجرای گزارش‌های شبانه.

خطاهای اصالت‌سنجی

AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK

خلاصه
کاربر سعی کرد بااستفاده از حسابی که قبلاً با شبکه‌ای مرتبط شده است، شبکه آزمایشی ایجاد کند.
دلایل متداول
کاربر قبل‌از فراخوانی NetworkService.makeTestNetwork()، حساب Google جدیدی ایجاد نکرده است.
نکات توصیه‌شده برای جابه‌جایی
قبل‌از تماس گرفتن، حساب کاملاً جدیدی ایجاد کنید NetworkService.makeTestNetwork(). برای اطلاعات بیشتر، به نحوه ایجاد شبکه آزمایشی مراجعه کنید.

AuthenticationError.NETWORK_CODE_REQUIRED

خلاصه
کاربر networkCode ارائه نکرده است. برای درخواست، کد شبکه لازم است.
دلایل متداول
کدهای شبکه برای همه درخواست‌ها الزامی است، به‌جز NetworkService.getAllNetworks() و NetworkService.makeTestNetwork().
نکات توصیه‌شده برای جابه‌جایی
کد شبکه شبکه‌ای را که در سرایند درخواست به آن اشاره شده است اضافه کنید. فقط از کد شبکه‌ای استفاده کنید که برای ورود به سیستم حسابتان دردسترس است. می‌توانید کد را در وب‌سایت Ad Manager برای حسابتان، در صفحه «سرپرست > تنظیمات شبکه» در کنار «کد شبکه» پیدا کنید. اطلاعات بیشتر درباره تنظیم کد شبکه را می‌توانید در صفحه درخواست SOAP XML و سرایندهای پاسخ پیدا کنید.

AuthenticationError.NETWORK_NOT_FOUND

خلاصه
درخواست انجام نشد زیرا کد شبکه ارائه‌شده در پیکربندی در سرور پیدا نشد.
دلایل متداول
کد شبکه نادرستی در پیکربندی‌تان مشخص کرده‌اید.
نکات توصیه‌شده برای جابه‌جایی
فیلد «راه‌انداز» گزارش خطا اغلب شبکه صحیح را برای کاربر پیشنهاد می‌کند.

AuthenticationError.NO_NETWORKS_TO_ACCESS

خلاصه
کاربر با هیچ شبکه‌ای مرتبط نیست.
دلایل متداول
حساب تولیدتان را برای دسترسی به میانای برنامه‌سازی کاربردی فعال نکرده‌اید.
نکات توصیه‌شده برای جابه‌جایی
دسترسی میانای برنامه‌سازی کاربردی به محیط تولیدتان را فعال کنید. برای اطلاعات بیشتر، فعال کردن دسترسی به میانای برنامه‌سازی کاربردی را ببینید.

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

خلاصه
مشتری برای دسترسی به میانای برنامه‌سازی کاربردی در فهرست سفید قرار ندارد.
دلایل متداول
شبکه شما برای تولید در فهرست سفید قرار ندارد، اما کد شبکه را در سرصفحه SOAP ارائه کرده‌اید.
نکات توصیه‌شده برای جابه‌جایی
دسترسی به میانای برنامه‌سازی کاربردی را فعال کنید.

خطاهای اجازه

PermissionError.PERMISSION_DENIED

خلاصه
کاربر اجازه لازم را برای درخواست ندارد.
دلایل متداول
  • سعی کردید به شیئی دسترسی پیدا کنید که در شبکه دیگری وجود دارد.
  • سعی کردید به هدفی دسترسی پیدا کنید که در شبکه‌تان وجود دارد، اما اجازه خواندن یا به‌روزرسانی آن را ندارید.
  • سعی کردید کاری را انجام دهید که مستلزم فعال بودن ویژگی دیگری در حسابتان است.
نکات توصیه‌شده برای جابه‌جایی
  • اگر درحال ایجاد میانای کاربر هستید، به کاربر نشان دهید که اجازه انجام این کنش را ندارد و باید با سرپرست خود صحبت کند.
  • اگر سعی کردید کاری را انجام دهید، مثلاً کاری که شامل ویژگی فقط پولی است که شبکه شما اجازه انجام آن را ندارد، با مدیر حسابتان درباره فعال کردن این ویژگی صحبت کنید.
  • به‌خاطر داشته باشید که شبکه‌های آزمایشی به‌طور پیش‌فرض شبکه‌های Ad Manager 360 نیستند، یعنی ویژگی‌های پولی موجود در شبکه‌های Ad Manager 360 را ندارند. برای فعال کردن ویژگی‌ها در شبکه آزمایشی‌تان، با مدیر حسابتان صحبت کنید.

خطاهای نسخه

ApiVersionError.UPDATE_TO_NEWER_VERSION

خلاصه
برنامه یا: درخواستی را آغاز کرده است که برای موفقیت به نسخه جدیدتری نیاز دارد؛ یا درخواستی را برای نسخه‌ای منسوخ‌شده آغاز کرده است.
دلایل متداول
  • نسخه فراخوانی میانای برنامه‌سازی کاربردی منسوخ شده است. لطفاً برای دریافت اعلامیه‌های منسوخ شدن، در وبلاگ ما مشترک شوید.
  • درخواستی که ارائه کردید برای موفقیت به نسخه جدیدتری از API نیاز دارد. این مورد اغلب زمانی اتفاق می‌افتد که ویژگی‌ای در میانای کاربر معرفی شده باشد و برای اینکه API شیء را به‌درستی ارسال کند، به نسخه جدیدتری از API نیاز است.
نکات توصیه‌شده برای جابه‌جایی
  • از نسخه‌های میانای برنامه‌سازی کاربردی مطلع باشید؛ برای ارتقا دادن منظم برنامه‌ریزی کنید.
  • برای مطلع شدن از موارد منسوخ‌شده، در وبلاگ ما مشترک شوید.

خطای ۴۰۴

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

خطای Unmarshalling

خلاصه
SOAP XML در درخواست شما با مشخصات WSDL مطابقت نداشت.
دلایل متداول
درخواست حاوی فیلدها یا نهادهایی است که در مشخصات WSDL یا در فضای نام اشتباه گنجانده نشده‌اند.
نوع داده‌ها در درخواست مطابقت ندارد (مثلاً فیلد عدد صحیح دارای مقدار رشته‌ای است).
نکات توصیه‌شده برای جابه‌جایی
مطمئن شوید درخواستتان با مشخصات WSDL مطابقت داشته باشد.
از کتابخانه کارخواه برای تولید SOAP معتبر استفاده کنید و از آن برای مقایسه استفاده کنید. همه کتابخانه‌های کارخواه از ثبت درخواست‌ها و پاسخ‌های SOAP پشتیبانی می‌کنند.