درخواست رد میشود زیرا کد دسترسی ارائهشده شامل حوزه 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 تغییر دهید تا از منقضی شدن کد نوسازی ظرف ۷ روز جلوگیری کنید.
این عامل را نمیتوان با زیرکلاسی از «آگهی» استفاده کرد.
دلایل متداول
تلاش برای اصلاح مشخصههایی غیراز status آگهی.
نحوه رسیدگی
نامشخص
نکات پیشگیری
پساز ایجاد آگهی، نمیتوان آن را تغییر داد. اگر میخواهید آگهی را اصلاح کنید، باید آگهی جدیدی بسازید و سپس آگهی قدیمی را بردارید. بااینحال، status آگهی بااستفاده از MutateAdGroupAds قابلتغییر است.
INVALID_INPUT
خلاصه
یکی از فیلدهای آگهی نویسههای نامعتبر دارد.
دلایل متداول
استفاده از نویسههای خاص در نشانیهای وب.
نحوه رسیدگی
نامشخص
نکات پیشگیری
پیشاز درخواست میانای برنامهسازی کاربردی، نشانیهای وب را در برنامهتان اعتبارسنجی کنید.
گروه آگهیای درحال اضافه شدن یا تغییر نام است، اما نام آن قبلاً توسط گروه آگهی دیگری استفاده شده است.
دلایل متداول
ایجاد گروه آگهی جدید با نام گروه آگهی فعال یا موقتاً متوقفشده موجود.
نحوه رسیدگی
خطا را ثبت کنید و پیام خطایی به کاربر ارائه دهید، و بهصورت اختیاری نام گروه آگهی منحصربهفردی را پیشنهاد دهید یا فهرست نامهای درحال استفاده را نشان دهید.
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 Ads لغوشده مراجعه کنید.
نکات پیشگیری
میتوانید با بررسی وضعیت لغوشده، بهطور پیشگیرانه بررسی کنید که آیا حساب مشتری غیرفعال شده است یا نه.
USER_PERMISSION_DENIED
خلاصه
مشتری مجاز به مشتری عامل دسترسی ندارد.
دلایل متداول
احراز هویت بهعنوان کاربری که به حساب مدیر دسترسی دارد اما login-customer-id را در درخواست مشخص نمیکند.
نحوه رسیدگی
نامشخص
نکات پیشگیری
login-customer-id را بهعنوان شناسه حساب مدیر بدون خط تیره (-) مشخص کنید. کتابخانههای کارخواه از این ویژگی پشتیبانی میکنند.
پویشی درحال اضافه شدن یا تغییر نام است، اما نام آن ازقبل توسط پویش دیگری استفاده میشود.
دلایل متداول
ایجاد پویش جدید با نام پویش فعال یا متوقفشده موجود.
نحوه رسیدگی
خطا را ثبت کنید و پیام خطایی به کاربر ارائه دهید، و بهصورت اختیاری نام پویش یکتایی را پیشنهاد دهید یا فهرست نامهای درحال استفاده را نشان دهید.
نکات پیشگیری
نامشخص
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE
خلاصه
تلاش برای تغییر تنظیم نوع مطابقت کلیدواژه سطح پویش در پویشی که «بیشینهسازی هوشوارهای» در آن فعال است.
دلایل متداول
با فعال شدن «بیشینهسازی هوشوارهای»، تنظیمات انطباق تقریبی در سطح پویش منسوخ میشوند زیرا همه کلیدواژهها بهطور پیشفرض بهعنوان انطباق تقریبی درنظر گرفته میشوند. تلاش برای تنظیم یا اصلاح این فیلد باعث ایجاد خطا میشود.
نحوه رسیدگی
به کاربر توصیه کنید بهجای تنظیم انطباق تقریبی در سطح پویش، از پارامتر `disable_search_term_matching` در سطح گروه آگهی استفاده کند.
نکات پیشگیری
اگر `ai_max_setting.enable_ai_max` روی `true` تنظیم شده است، از تنظیم `keyword_match_type` روی `BROAD` (یا هر مقدار دیگری) در پویش خودداری کنید. بااستفاده از `disable_search_term_matching` مطابقت عبارت جستجو را در سطح گروه آگهی تغییر دهید.
میانای برنامهسازی کاربردی بهدلیل وجود اشکال بهدرستی کار نمیکند.
نحوه رسیدگی
هر درخواستی را که با این خطا ناموفق بوده است دوباره امتحان کنید و برای امتحان مجدد از زمانبندی عقبگرد نمایی استفاده کنید.
نکات پیشگیری
نامشخص
TRANSIENT_ERROR
خلاصه
خطای داخلی گذرا روی داده است و باید دوباره امتحان کنید.
دلایل متداول
این خطا زمانی رخ میدهد که میانای برنامهسازی کاربردی بهطور داخلی با مشکل موقتی مواجه شود.
نحوه رسیدگی
هر درخواستی را که با این خطا ناموفق بوده است دوباره امتحان کنید و برای امتحان مجدد از زمانبندی عقبگرد نمایی استفاده کنید.
نکات پیشگیری
نامشخص
InvalidGrantError
invalid_grant (malformed auth code)
خلاصه
کد مجوز معاوضهشده با کدهای OAuth بدشکل بود.
دلایل متداول
این اتفاق زمانی رخ میدهد که تلاش میکنید برای کاربری که قبلاً به برنامه درخواستکننده دسترسی داده است، کد بازآوری تولید کنید. برای مثال، این وضعیت میتواند زمانی رخ دهد که مثال «تولید اطلاعات کاربری کاربر» را بیشاز یکبار برای اطلاعات اعتباری کارخواه OAuth یکسان و کاربر مجاز اجرا کنید.
نحوه رسیدگی
برای بازتولید ژتون بازآوری برای ترکیب مشخصی از کاربر مجوزدهنده و اطلاعات کاربری کارخواه OAuth، ژتون بازآوری موجود را لغو کنید. توجه داشته باشید که با باطل کردن یک کد، آن کد برای دسترسی به «میانای برنامهسازی کاربردی Google Ads» غیرقابل استفاده میشود و همه کدهای دسترسی که از کد بازآوری برای تولید آنها استفاده شده است نامعتبر میشوند.
نکات پیشگیری
حتماً ژتون بازآوریتان را در مکانی امن ذخیره کنید تا نیازی به تولید مجدد آن نباشد.
درخواست تلاش کرده است منبعی را که وجود ندارد یا برداشته شده است تغییر دهد یا به آن ارجاع دهد. یا نام منبع ارائهشده برای منبع بدشکل است.
نحوه رسیدگی
از درخواست جستجو برای بازیابی نام منبع برای منبع موجود قبلاز ارسال درخواست تغییر استفاده کنید. راهنماهای کتابخانه مشتری ما را مرور کنید که شامل اسنادی درباره نحوه ساختن نامهای منبع معتبر در هر زبان پشتیبانیشده است
نکات پیشگیری
نام منابع را بهصورت دستی ایجاد نکنید. از یکی از روشهای کمکی ارائهشده توسط کتابخانههای مشتری ما استفاده کنید.
درخواست در تلاش است منبعی ایجاد کند که باعث میشود تعداد کل آن منابع از حد مشخصشده فراتر رود.
دلایل متداول
محدودیتهای متعددی برای تعداد منابعی که میتوانند در زمینههای خاص وجود داشته باشند وجود دارد.
نحوه رسیدگی
با مرور محدودیتهای سیستم، محدودیتی را که با آن مواجه شدهاید شناسایی کنید. یا از منبع موجودی دوباره استفاده کنید یا منابع را بردارید تا برای منابع جدید فضا ایجاد شود.
نکات پیشگیری
از پُرسمانهای جستجو برای نظارت بر تعداد منابعی که محدودیت دارند استفاده کنید.
تاریخ آخرین بهروزرسانی 2026-10-14 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-14 بهوقت ساعت هماهنگ جهانی."],[],[]]