خطاهای رایج

این صفحه رایج‌ترین خطاهایی را که توسط API مدیریت تبلیغات گوگل (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() یک حساب کاربری گوگل جدید ایجاد نکرده است.
نکات مربوط به جابجایی توصیه شده
قبل از فراخوانی NetworkService.makeTestNetwork() یک حساب کاربری کاملاً جدید ایجاد کنید. برای اطلاعات بیشتر به نحوه ایجاد یک شبکه آزمایشی مراجعه کنید.

AuthenticationError.NETWORK_CODE_REQUIRED

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

AuthenticationError.NETWORK_NOT_FOUND

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

AuthenticationError.NO_NETWORKS_TO_ACCESS

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

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

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

خطاهای مجوز

PermissionError.PERMISSION_DENIED

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

خطاهای نسخه

ApiVersionError.UPDATE_TO_NEWER_VERSION

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

خطای ۴۰۴

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

خطای Unmarshalling

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