خطاهای رایج

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

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

google.rpc.ErrorInfo

ACCESS_TOKEN_SCOPE_INSUFFICIENT
خلاصه توکن دسترسی OAuth 2.0 دامنه‌های مورد نیاز را ندارد.
علل شایع درخواست رد می‌شود زیرا توکن دسترسی ارائه شده شامل محدوده‌ی OAuth 2.0 مربوط به API تبلیغات گوگل نمی‌شود.
نحوه رسیدگی مطمئن شوید که توکن دسترسی، محدوده‌های مورد نیاز را دارد. یکی از دلایل رایج این خطا این است که شما در حال استفاده مجدد از یک توکن دسترسی موجود هستید که با استفاده از مجموعه‌ای متفاوت از محدوده‌های OAuth تولید شده است. برای مثالی از نحوه تولید یک توکن دسترسی جدید با محدوده‌های مورد نیاز، به پارامترهای مجوز OAuth مراجعه کنید.
نکات پیشگیری مطمئن شوید که توکن دسترسی، محدوده‌های مورد نیاز را دارد. برای دسترسی به محدوده‌های مورد نیاز، کاربر خود را با محدوده‌های مورد نیاز مجدداً احراز هویت کنید. اگر برنامه شما از چندین محدوده OAuth استفاده می‌کند، ممکن است نیاز به پیاده‌سازی مجوزهای Granular OAuth داشته باشید.

google.auth.exceptions.RefreshError

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

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
خلاصه شناسه مشتری کلاینت یک عدد نیست.
علل شایع استفاده از شناسه مشتری نامناسب.
نحوه رسیدگی ناموجود
نکات پیشگیری ۱۲۳-۴۵۶-۷۸۹۰ باید ۱۲۳۴۵۶۷۸۹۰ باشد. برای جزئیات بیشتر به «شروع به کار» مراجعه کنید.
CLIENT_CUSTOMER_ID_IS_REQUIRED
خلاصه شناسه مشتری کلاینت در هدر HTTP مشخص نشده است.
علل شایع عدم مشخص کردن شناسه مشتری کلاینت در هدر HTTP.
نحوه رسیدگی ناموجود
نکات پیشگیری شناسه مشتری کلاینت برای همه فراخوانی‌ها لازم است، بنابراین مطمئن شوید که آن را در هدر HTTP مشخص کرده‌اید. استفاده از کتابخانه‌های کلاینت ما را در نظر بگیرید زیرا آنها این کار را برای شما انجام می‌دهند.
CUSTOMER_NOT_FOUND
خلاصه هیچ حسابی برای شناسه مشتری ارائه شده در سربرگ یافت نشد.
علل شایع تلاش برای دسترسی به حسابی که قبل از ایجاد حساب در backend ایجاد شده است.
نحوه رسیدگی پنج دقیقه اول صبر کنید، سپس هر 30 ثانیه دوباره امتحان کنید.
نکات پیشگیری قبل از ارسال درخواست علیه حساب، چند دقیقه پس از ایجاد حساب صبر کنید.
خلاصه توکن دسترسی موجود در هدر درخواست یا نامعتبر است یا منقضی شده است.
علل شایع توکن دسترسی نامعتبر شده است.
نحوه رسیدگی درخواست یک توکن جدید. اگر از یکی از کتابخانه‌های کلاینت ما استفاده می‌کنید، برای نحوه به‌روزرسانی توکن، به مستندات آن مراجعه کنید.
نکات پیشگیری توکن‌های دسترسی را تا زمان انقضا ذخیره و دوباره استفاده کنید.
NOT_ADS_USER
خلاصه حساب گوگلی که برای تولید توکن دسترسی استفاده می‌شود، به هیچ حساب گوگل ادز مرتبط نیست.
علل شایع اطلاعات ورود ارائه شده مربوط به یک حساب گوگل است که تبلیغات گوگل در آن فعال نیست.
نحوه رسیدگی مطمئن شوید که برای جریان OAuth با یک حساب کاربری معتبر گوگل ادز (معمولاً حساب کاربری مدیر شما) وارد سیستم می‌شوید. همچنین می‌توانید با ورود به حساب کاربری مدیر خود، انتخاب حساب کاربری مشتری یا مدیر مورد نظر، رفتن به Tools and Settings > Access and security و سپس اضافه کردن آدرس ایمیل حساب کاربری گوگل، حساب کاربری گوگل را برای دسترسی به یک حساب کاربری گوگل ادز موجود دعوت کنید.
نکات پیشگیری ناموجود
OAUTH_TOKEN_INVALID
خلاصه توکن دسترسی OAuth در هدر معتبر نیست.
علل شایع توکن دسترسی شما که با هدر HTTP ارسال شده بود، صحیح نبود.
نحوه رسیدگی ناموجود
نکات پیشگیری مطمئن شوید که توکن دسترسی صحیح مرتبط با حساب کاربری خود را وارد کرده‌اید. گاهی اوقات با توکن‌های تازه‌سازی و کدهای مجوز اشتباه گرفته می‌شود. اگر می‌خواهید اعتبارنامه‌ای دریافت کنید که بتواند به همه حساب‌های کاربری تحت یک حساب کاربری مدیر دسترسی داشته باشد، مطمئن شوید که توکن تازه‌سازی را برای حساب کاربری مدیر دریافت کرده‌اید. به راهنمای احراز هویت کاربر مراجعه کنید.

AuthorizationError

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

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