خطاهای رایج

این راهنما خطاهای رایج API را فهرست می‌کند و راهبردهایی برای جلوگیری و مدیریت آن‌ها ارائه می‌دهد.

برای مشاهده فهرست جامع همه انواع خطا، به مرجع خطای Google Ads API مراجعه کنید. اگر به کمک بیشتری نیاز دارید، در تالار گفتمان Google Ads API سؤال بپرسید.

google.rpc.ErrorInfo
ACCESS_TOKEN_SCOPE_INSUFFICIENT
خلاصهکد دسترسی OAuth 2.0 دامنه‌های موردنیاز را ندارد.
دلایل متداول درخواست رد شد زیرا کد دسترسی ارائه‌شده شامل دامنه Google Ads API OAuth 2.0 نیست.
نحوه رسیدگی مطمئن شوید که کد دسترسی دارای حوزه‌های موردنیاز است. دلیل رایج این خطا این است که شما از یک کد دسترسی موجود که بااستفاده از مجموعه دیگری از محدوده‌های OAuth تولید شده است، مجدداً استفاده می‌کنید. برای نمونه‌ای از نحوه تولید یک کد دسترسی جدید با محدوده‌های موردنیاز، پارامترهای مجوز OAuth را ببینید.
نکات پیشگیری مطمئن شوید که کد دسترسی دارای دامنه‌های لازم باشد. کاربرتان را با دامنه‌های لازم دوباره اصالت‌سنجی کنید تا دسترسی با دامنه‌های لازم را به‌دست آورید. اگر برنامه‌تان از چند دامنه OAuth استفاده می‌کند، ممکن است لازم باشد اجازه‌های OAuth جزئی را پیاده‌سازی کنید.

google.auth.exceptions.RefreshError
invalid_grant
خلاصهتوکن منقضی یا لغو شده است.
دلایل متداول برای پروژه Google Cloud Platform با صفحه رضایت OAuth پیکربندی‌شده برای نوع کاربر خارجی و وضعیت انتشار Testing، ژتون بازآوری با تاریخ انقضای ۷ روز صادر می‌شود.
نحوه رسیدگی وضعیت انتشار پروژه Google شما Testing است، بنابراین ژتون بازآوری هر ۷ روز منقضی می‌شود و خطای invalid_grant دریافت می‌کند. به «کنسول Google API» بروید و به صفحه کسب رضایت OAuth پیمایش کنید. سپس وضعیت انتشار را به In production تغییر دهید تا ژتون بازآوری ظرف ۷ روز منقضی نشود.
نکات پیشگیری برنامه‌های تأییدنشده را ببینید.

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID
خلاصهشناسه مشتری کارخواه عدد نیست.
دلایل متداول از شناسه مشتری کارخواه نامناسب استفاده می‌کنید.
نحوه رسیدگی نامشخص
نکات پیشگیری ‫123-456-7890 باید 1234567890 باشد. برای جزئیات، به شروع به کار بروید.
CLIENT_CUSTOMER_ID_IS_REQUIRED
خلاصهشناسه مشتری کارخواه در سرصفحه HTTP مشخص نشده است.
دلایل متداول شناسه مشتری کارخواه را در سرصفحه HTTP مشخص نمی‌کنید.
نحوه رسیدگی نامشخص
نکات پیشگیری شناسه مشتری کارخواه برای همه تماس‌ها الزامی است، بنابراین مطمئن شوید که یکی را در سرصفحه HTTP مشخص کرده‌اید. استفاده از کتابخانه‌های مشتری ما را مدنظر قرار دهید زیرا این کار را برای شما انجام می‌دهند.
CUSTOMER_NOT_FOUND
خلاصههیچ حسابی برای شناسه مشتری ارائه‌شده در سرصفحه پیدا نشد.
دلایل متداول تلاش برای دسترسی به حسابی که به‌تازگی ایجاد شده است، قبل‌از اینکه حساب در پس‌زمینه ایجاد شود.
نحوه رسیدگی ابتدا پنج دقیقه صبر کنید، سپس هر ۳۰ ثانیه دوباره امتحان کنید.
نکات پیشگیری پس‌از ایجاد حساب، چند دقیقه صبر کنید و سپس درخواست‌های مربوط به آن را صادر کنید.
خلاصهکد دسترسی در سرایند درخواست نامعتبر است یا منقضی شده است.
دلایل متداول کد دسترسی نامعتبر شده است.
نحوه رسیدگی درخواست کد جدید. اگر از یکی از کتابخانه‌های مشتری ما استفاده می‌کنید، برای نحوه بازآوری کردن کد به اسناد آن مراجعه کنید.
نکات پیشگیری کدهای دسترسی را تا زمان انقضا ذخیره کنید و دوباره استفاده کنید.
NOT_ADS_USER
خلاصهحساب Google استفاده‌شده برای تولید کد دسترسی با هیچ حساب Google Ads مرتبط نیست.
دلایل متداول اطلاعات ورود به سیستم ارائه‌شده مربوط به حساب Google است که Google Ads در آن فعال نیست.
نحوه رسیدگی حتماً با حساب Google Ads معتبری (معمولاً حساب مدیرتان) برای جریان OAuth به سیستم وارد شوید. همچنین می‌توانید با ورود به سیستم حساب مدیرتان، انتخاب حساب مشتری یا مدیر موردنظر، پیمایش به Tools and Settings > Access and security، و سپس افزودن نشانی ایمیل حساب Google، حساب Google را برای دسترسی به حساب Google Ads موجود دعوت کنید.
نکات پیشگیری نامشخص
OAUTH_TOKEN_INVALID
خلاصهکد دسترسی OAuth در سرایند معتبر نیست.
دلایل متداول نمودار دسترسی شما که با سرایند HTTP ارسال شده است صحیح نیست.
نحوه رسیدگی نامشخص
نکات پیشگیری مطمئن شوید کد دسترسی صحیح مرتبط با حسابتان را ارسال کرده‌اید. گاهی با نشان‌های بازآوری و کدهای مجوز اشتباه گرفته می‌شود. اگر می‌خواهید اطلاعات اعتباری‌ای دریافت کنید که بتواند به همه حساب‌های مشتری تحت حساب مدیر دسترسی داشته باشد، حتماً ژتون بازآوری را برای حساب مدیر دریافت کنید. به راهنمای اصالت‌سنجی کاربر مراجعه کنید.

AuthorizationError
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
خلاصهپروژه Google Cloud فقط دسترسی «آزمایشی» دارد و نمی‌توان از آن برای دسترسی به حساب‌های تولید استفاده کرد.
دلایل متداول از پروژه Google Cloud با سطح دسترسی «آزمایشی» برای درخواست دربرابر حساب Google Ads غیرآزمایشی (تولید) استفاده شده است. (در نسخه‌های v24 و قدیمی‌تر «میانای برنامه‌سازی کاربردی»، این وضعیت AuthorizationError.ACTION_NOT_PERMITTED را برمی‌گرداند.)
نحوه رسیدگی اگر درحال آزمایش هستید، مطمئن شوید درخواستتان حساب آزمایشی را هدف قرار می‌دهد. اگر می‌خواهید به حساب Google Ads تولیدی دسترسی داشته باشید، سطح دسترسی پروژه Google Cloud خود را در صفحه نمای کلی Google Ads API بررسی کنید و سطح دسترسی پروژه خود را به دسترسی «کاوشگر»، «پایه»، یا «استاندارد» ارتقا دهید.
نکات پیشگیری نامشخص
CUSTOMER_NOT_ENABLED
خلاصهدسترسی به حساب مشتری امکان‌پذیر نیست زیرا در وضعیت فعال قرار ندارد.
دلایل متداول این اتفاق زمانی می‌افتد که حساب مشتری ثبت‌نام را تکمیل نکرده باشد یا غیرفعال شده باشد.
نحوه رسیدگی به سیستم «میانای کاربری Google Ads» وارد شوید و مطمئن شوید که فرایند ثبت‌نام را برای این حساب تکمیل کرده‌اید. برای حساب‌های غیرفعال‌شده، به بازفعال کردن حساب Google Ads لغوشده مراجعه کنید.
نکات پیشگیری می‌توانید با بررسی وضعیت لغوشده، به‌طور پیش‌گیرانه بررسی کنید که آیا حساب مشتری غیرفعال شده است یا نه.
USER_PERMISSION_DENIED
خلاصهمشتری مجاز به مشتری عامل دسترسی ندارد.
دلایل متداول اصالت‌سنجی به‌عنوان کاربری که به حساب مدیر دسترسی دارد اما login-customer-id را در درخواست مشخص نمی‌کند.
نحوه رسیدگی نامشخص
نکات پیشگیری login-customer-id را به‌عنوان شناسه حساب مدیر بدون خط تیره (-) مشخص کنید. کتابخانه‌های کارخواه از این ویژگی پشتیبانی می‌کنند.

قبلی
مدیریت خطاها
بعدی
مراحل بعدی