درخواست رد شد زیرا کد دسترسی ارائه‌شده شامل دامنه 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 تغییر دهید تا ژتون بازآوری ظرف ۷ روز منقضی نشود.
123-456-7890 باید 1234567890 باشد. برای جزئیات، به شروع به کار مراجعه کنید.
CLIENT_CUSTOMER_ID_IS_REQUIRED
خلاصه
شناسه مشتری کارخواه در سرصفحه HTTP مشخص نشده است.
دلایل متداول
شناسه مشتری کارخواه در سرصفحه HTTP مشخص نشده است.
نحوه رسیدگی
نامشخص
نکات پیشگیری
شناسه مشتری کارخواه برای همه تماس‌ها لازم است، بنابراین مطمئن شوید که آن را در سرایند HTTP مشخص کرده‌اید. استفاده از کتابخانه‌های مشتری ما را مدنظر قرار دهید زیرا این کار را برای شما انجام می‌دهند.
CUSTOMER_NOT_FOUND
خلاصه
هیچ حسابی برای شناسه مشتری ارائه‌شده در سرصفحه پیدا نشد.
دلایل متداول
تلاش برای دسترسی به حسابی که به‌تازگی ایجاد شده است، قبل‌از اینکه حساب در پس‌زمینه ایجاد شود.
نحوه رسیدگی
ابتدا پنج دقیقه صبر کنید، سپس هر ۳۰ ثانیه دوباره امتحان کنید.
نکات پیشگیری
پس‌از ایجاد حساب، چند دقیقه صبر کنید و سپس درخواست‌های مربوط به آن را صادر کنید.
GOOGLE_ACCOUNT_COOKIE_INVALID
خلاصه
کد دسترسی در سرایند درخواست نامعتبر است یا منقضی شده است.
دلایل متداول
کد دسترسی نامعتبر شده است.
نحوه رسیدگی
درخواست کد جدید. اگر از یکی از کتابخانه‌های مشتری ما استفاده می‌کنید، برای اطلاع از نحوه بازآوری کردن کد، به اسناد آن مراجعه کنید.
نکات پیشگیری
کدهای دسترسی را تا زمانی که منقضی شوند ذخیره کنید و دوباره استفاده کنید.
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 ارسال شده است درست نبود.
نحوه رسیدگی
نامشخص
نکات پیشگیری
مطمئن شوید کد دسترسی صحیح مرتبط با حسابتان را ارسال کرده‌اید. گاهی با ژتون بازآوری و کدهای مجوز اشتباه گرفته می‌شود. اگر می‌خواهید اطلاعات اعتباری‌ای دریافت کنید که بتواند به همه حساب‌های مشتری تحت حساب مدیر دسترسی داشته باشد، حتماً ژتون بازآوری را برای حساب مدیر دریافت کنید. راهنمای اصالت‌سنجی کاربر را ببینید.
پروژه Google Cloud فقط دسترسی «آزمایشی» دارد و نمی‌توان از آن برای دسترسی به حساب‌های تولید استفاده کرد.
دلایل متداول
از پروژه Google Cloud با سطح دسترسی آزمایشی برای درخواست از حساب Google Ads غیرآزمایشی (تولید) استفاده شده است. (در نسخه‌های میانای برنامه‌سازی کاربردی v24 و قدیمی‌تر، این شرط AuthorizationError.ACTION_NOT_PERMITTED را برمی‌گرداند.)
نحوه رسیدگی
اگر درحال آزمایش هستید، مطمئن شوید درخواستتان حساب آزمایشی را هدف قرار می‌دهد. اگر می‌خواهید به حساب Google Ads تولیدی دسترسی پیدا کنید، سطح دسترسی پروژه Google Cloud خود را در صفحه نمای کلی Google Ads API بررسی کنید و سطح دسترسی پروژه خود را به دسترسی Explorer، «پایه»، یا «استاندارد» ارتقا دهید.
نکات پیشگیری
نامشخص
CUSTOMER_NOT_ENABLED
خلاصه
دسترسی به حساب مشتری امکان‌پذیر نیست زیرا در وضعیت فعال نیست.
دلایل متداول
این اتفاق زمانی می‌افتد که حساب مشتری ثبت‌نام را تکمیل نکرده باشد یا غیرفعال شده باشد.
نحوه رسیدگی
به سیستم واسط کاربر Google Ads وارد شوید و مطمئن شوید که فرایند ثبت‌نام را برای این حساب تکمیل کرده‌اید. برای حساب‌های غیرفعال‌شده، به فعال کردن مجدد حساب Google Ads لغوشده مراجعه کنید.
نکات پیشگیری
می‌توانید با بررسی وضعیت لغوشده، به‌طور پیش‌گیرانه بررسی کنید که آیا حساب مشتری غیرفعال شده است یا نه.
USER_PERMISSION_DENIED
خلاصه
مشتری مجاز به مشتری عامل دسترسی ندارد.
دلایل متداول
اصالت‌سنجی به‌عنوان کاربری که به حساب مدیر دسترسی دارد اما login-customer-id را در درخواست مشخص نمی‌کند.
نحوه رسیدگی
نامشخص
نکات پیشگیری
login-customer-id را به‌عنوان شناسه حساب مدیر بدون خط تیره (-) مشخص کنید. کتابخانه‌های کارخواه از این ویژگی پشتیبانی داخلی دارند.
تاریخ آخرین به‌روزرسانی 2026-10-30 به‌وقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین به‌روزرسانی 2026-10-30 به‌وقت ساعت هماهنگ جهانی."],[],[]]
