خطاهای رایج

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

خطاهای محدودیت موجودیت

EntityChildrenLimitReachedError

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

خطاهای سهمیه ای

QuotaError.EXCEEDED_QUOTA

خلاصه
تعداد درخواست‌های ارسال شده در ثانیه بسیار زیاد است و از حد مجاز فراتر رفته است.
نکاتی برای دست زدن
  • از روش‌های دسته‌ای مانند updateLineItems با جمع‌آوری تغییرات به صورت محلی و ایجاد یک درخواست واحد برای انجام آن تغییرات به یکباره استفاده کنید.
  • حدود 5 ثانیه صبر کنید و سپس درخواست را دوباره امتحان کنید. توجه داشته باشید که این تضمین نمی کند که درخواست موفق شود. اگر دوباره شکست خورد، سعی کنید زمان انتظار را افزایش دهید. این برای برنامه های تعاملی ادغام شده با 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 مربوط به حساب خود، در صفحه Admin > Network Settings در کنار «کد شبکه» پیدا کنید. اطلاعات بیشتر در مورد تنظیم کد شبکه خود را می توانید در صفحه سرصفحه درخواست و پاسخ SOAP XML بیابید.

AuthenticationError.NETWORK_NOT_FOUND

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

AuthenticationError.NO_NETWORKS_TO_ACCESS

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

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

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

خطاهای مجوز

PermissionError.PERMISSION_DENIED

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

خطاهای نسخه

ApiVersionError.UPDATE_TO_NEWER_VERSION

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

خطای 404

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

خطای بازگشایی

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

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

خطاهای محدودیت نهاد

EntityChildrenLimitReachedError

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

خطاهای سهمیه ای

QuotaError.EXCEEDED_QUOTA

خلاصه
تعداد درخواست‌های ارسال شده در هر ثانیه بسیار زیاد است و از حد مجاز فراتر رفته است.
نکاتی برای دست زدن
  • از روش‌های دسته‌ای مانند updateLineItems با جمع‌آوری تغییرات به صورت محلی و ایجاد یک درخواست واحد برای انجام این تغییرات به‌صورت یکجا استفاده کنید.
  • حدود 5 ثانیه صبر کنید و سپس درخواست را دوباره امتحان کنید. توجه داشته باشید که این تضمین نمی کند که درخواست موفق شود. اگر دوباره شکست خورد، سعی کنید زمان انتظار را افزایش دهید. این برای برنامه‌های تعاملی که با 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 مربوط به حساب خود، در صفحه Admin > Network Settings در کنار «کد شبکه» پیدا کنید. اطلاعات بیشتر در مورد تنظیم کد شبکه خود را می توانید در صفحه سرصفحه درخواست و پاسخ SOAP XML بیابید.

AuthenticationError.NETWORK_NOT_FOUND

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

AuthenticationError.NO_NETWORKS_TO_ACCESS

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

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

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

خطاهای مجوز

PermissionError.PERMISSION_DENIED

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

خطاهای نسخه

ApiVersionError.UPDATE_TO_NEWER_VERSION

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

خطای 404

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

خطای بازگشایی

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