خطاهای رایج

این صفحه خطاهای رایج را فهرست کرده و نکاتی در مورد پیشگیری و مدیریت آنها ارائه می‌دهد. برای مشاهده لیست کامل خطاها، مرجع خطا ، راهنمای درک خطاهای 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 تغییر دهید تا از منقضی شدن توکن به‌روزرسانی ظرف ۷ روز جلوگیری شود.
نکات پیشگیری برنامه‌های تأیید نشده را ببینید.

AdError

CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR
خلاصه این عملگر را نمی‌توان با زیرکلاس Ad استفاده کرد.
علل شایع تلاش برای تغییر ویژگی‌هایی غیر از status تبلیغ.
نحوه رسیدگی ناموجود
نکات پیشگیری پس از ایجاد یک تبلیغ، دیگر نمی‌توان آن را تغییر داد. اگر می‌خواهید تبلیغ را تغییر دهید، باید یک تبلیغ جدید ایجاد کنید و سپس تبلیغ قدیمی را حذف کنید. با این حال، status تبلیغ با استفاده از MutateAdGroupAds قابل تغییر است.
INVALID_INPUT
خلاصه یکی از فیلدهای یک تبلیغ حاوی نویسه‌های نامعتبر است.
علل شایع استفاده از کاراکترهای ویژه در URLها
نحوه رسیدگی ناموجود
نکات پیشگیری قبل از ارسال درخواست API، URL ها را در برنامه خود اعتبارسنجی کنید.
LINE_TOO_WIDE
خلاصه یکی از فیلدهای یک آگهی طولانی‌تر از حداکثر طول مجاز بود. به بخش «درباره تبلیغات متنی» مراجعه کنید.
علل شایع داشتن یک خط متن خیلی طولانی.
نحوه رسیدگی ناموجود
نکات پیشگیری قبل از ارسال درخواست API، طول خط را اعتبارسنجی کنید.

AdGroupAdError

AD_GROUP_AD_LABEL_ALREADY_EXISTS
خلاصه این برچسب از قبل با برخی از تبلیغات مرتبط است.
علل شایع تلاش برای مرتبط کردن برچسب با تبلیغاتی که قبلاً مرتبط شده‌اند.
نحوه رسیدگی ناموجود
نکات پیشگیری ابتدا بررسی کنید که آیا برچسبی که قرار است اضافه شود از قبل با تبلیغات مرتبط است یا خیر.
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD
خلاصه در عملیاتی سعی شد یک آگهی حذف شده به‌روزرسانی شود.
علل شایع وقتی یک آگهی حذف می‌شود، دیگر نمی‌توان آن را به‌روزرسانی کرد—از جمله تغییر در وضعیت آن.
نحوه رسیدگی ناموجود
نکات پیشگیری مطمئن شوید که کد شما سعی در به‌روزرسانی تبلیغات حذف‌شده ندارد.

AdGroupCriterionError

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

AdGroupError

DUPLICATE_ADGROUP_NAME
خلاصه یک گروه تبلیغاتی اضافه یا تغییر نام داده می‌شود، اما این نام قبلاً توسط یک گروه تبلیغاتی دیگر استفاده می‌شود.
علل شایع ایجاد یک گروه تبلیغاتی جدید با نام یک گروه تبلیغاتی فعال یا متوقف شده موجود.
نحوه رسیدگی خطا را ثبت کنید و یک پیام خطا به کاربر نشان دهید، که به صورت اختیاری می‌تواند یک نام منحصر به فرد برای گروه تبلیغاتی پیشنهاد دهد یا لیست نام‌های مورد استفاده را نشان دهد.
نکات پیشگیری ناموجود

AssetError

DUPLICATE_ASSET
خلاصه دو عملیات در یک درخواست واحد شامل یک عملیات ایجاد برای یک دارایی با داده‌های دودویی یکسان است.
علل شایع یک درخواست تغییر با عملیات ایجاد تکراری حاوی داده‌های دودویی یکسان.
نحوه رسیدگی دارایی را در یک درخواست جداگانه ایجاد کنید، سپس در درخواست بعدی به آن پیوند دهید؛ یا از یک شناسه موقت در همان درخواست استفاده کنید.
نکات پیشگیری ناموجود

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 را به عنوان شناسه حساب مدیر بدون خط تیره ( - ) مشخص کنید. کتابخانه‌های کلاینت از این قابلیت پشتیبانی می‌کنند.

BiddingError

BID_TOO_MANY_FRACTIONAL_DIGITS
خلاصه مقدار پیشنهاد، مضرب دقیقی از حداقل واحد پول حساب نیست. برای مثال، 0.015 دلار آمریکا ( 15000 در واحد میکرو) یک پیشنهاد معتبر نیست.
علل شایع ناموجود
نحوه رسیدگی ناموجود
نکات پیشگیری بررسی کنید که پیشنهادها مضربی از حداقل واحد پول حساب باشند.
BID_TOO_BIG
خلاصه با اینکه مبلغ پیشنهادی در محدوده بودجه کمپین است، خطا بازگردانده می‌شود.
علل شایع ناموجود
نحوه رسیدگی ناموجود
نکات پیشگیری بررسی کنید که آیا حساب کاربری در Google Ad Grants شرکت می‌کند یا خیر. در این صورت، پیشنهادهای CPC را به حداکثر میزان تعیین‌شده توسط برنامه محدود کنید.

CampaignBudgetError

MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC
خلاصه مبلغ بودجه خیلی کمه.
علل شایع ناموجود
نحوه رسیدگی ناموجود
نکات پیشگیری تأیید کنید که مبلغ بودجه بزرگتر یا مساوی حداقل واحد پول حساب باشد.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT
خلاصه مبلغ بودجه هنگام تبدیل از یک مبلغ خرد به مبلغی به واحد پول حساب، ارقام اعشاری بسیار زیادی خواهد داشت.
علل شایع ناموجود
نحوه رسیدگی ناموجود
نکات پیشگیری تأیید کنید که مبلغ بودجه بر حداقل واحد پول حساب قابل تقسیم باشد.

CampaignError

DUPLICATE_CAMPAIGN_NAME
خلاصه یک کمپین در حال اضافه شدن یا تغییر نام است، اما این نام در حال حاضر توسط یک کمپین دیگر استفاده می‌شود.
علل شایع ایجاد یک کمپین جدید با نام یک کمپین فعال یا متوقف شده موجود.
نحوه رسیدگی خطا را ثبت کنید و یک پیام خطا به کاربر نشان دهید، که به صورت اختیاری می‌تواند یک نام کمپین منحصر به فرد پیشنهاد دهد یا لیست نام‌های مورد استفاده را نشان دهد.
نکات پیشگیری ناموجود
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE
خلاصه تلاش برای تغییر تنظیمات نوع تطابق کلمات کلیدی در سطح کمپین در یک کمپین با فعال بودن AI Max.
علل شایع با فعال بودن AI Max، تنظیمات تطابق گسترده در سطح کمپین منسوخ می‌شوند زیرا همه کلمات کلیدی به طور پیش‌فرض به عنوان تطابق گسترده در نظر گرفته می‌شوند. تلاش برای تنظیم یا تغییر این فیلد باعث بروز خطا خواهد شد.
نحوه رسیدگی به کاربر توصیه کنید به جای تنظیم تطابق گسترده در سطح کمپین، از پارامتر `disable_search_term_matching` در سطح گروه تبلیغاتی استفاده کند.
نکات پیشگیری اگر `ai_max_setting.enable_ai_max` روی `true` تنظیم شده است، از تنظیم `keyword_match_type` روی `BROAD` (یا هر مقدار دیگری) در کمپین خودداری کنید. تطبیق عبارت جستجو را در سطح گروه تبلیغاتی با استفاده از `disable_search_term_matching` تغییر دهید.

CriterionError

KEYWORD_HAS_INVALID_CHARS
خلاصه افزودن یا ویرایش کلمات کلیدی حاوی کاراکترهای نامعتبر.
علل شایع از کاراکترهای ویژه مانند ! @ % * در کلمات کلیدی استفاده کنید.
نحوه رسیدگی ناموجود
نکات پیشگیری مطمئن شوید که از هیچ کاراکتر غیرمجازی در کلمات کلیدی استفاده نمی‌کنید. به بخش افزودن کلمات کلیدی مراجعه کنید.

DistinctError

DUPLICATE_ELEMENT
خلاصه این درخواست شامل دو پارامتر یکسان و تکراری است.
علل شایع ناموجود
نحوه رسیدگی ناموجود
نکات پیشگیری قبل از ارسال درخواست، موارد تکراری (اعمال، پارامترها، عناصر لیست) را حذف کنید. به دنبال فیلدهایی باشید که محدودیت DistinctElements دارند.

InternalError

DEADLINE_EXCEEDED
خلاصه مهلت درخواست تمام شده و نمی‌تواند به سرعت کافی برای بازگرداندن پاسخ تکمیل شود.
علل شایع یک درخواست جستجو ایجاد شده که پاسخ بسیار بزرگی ایجاد کرده است، یا یک درخواست تغییر شکل برای پردازش بسیار بزرگ بوده است.
نحوه رسیدگی حدود 30 ثانیه صبر کنید، سپس درخواست را دوباره امتحان کنید. اگر خطا ادامه داشت، سعی کنید درخواست را به چندین درخواست کوچکتر تقسیم کنید که بتوانند سریعتر تکمیل شوند.
نکات پیشگیری برای درک چگونگی تأثیر Segmentation بر اندازه پاسخ، آن را مرور کنید. از محدودیت‌های لایه انتقال gRPC آگاه باشید.
INTERNAL_ERROR
خلاصه هنگام پردازش درخواست، اتفاق غیرمنتظره‌ای رخ داد.
علل شایع به دلیل وجود یک اشکال، API به درستی کار نمی‌کند.
نحوه رسیدگی هر درخواستی که با این خطا با شکست مواجه شده است را با استفاده از یک برنامه‌ی بازگشت نمایی برای تلاش‌های مجدد، دوباره امتحان کنید.
نکات پیشگیری ناموجود
TRANSIENT_ERROR
خلاصه یک خطای داخلی گذرا رخ داده است و باید دوباره امتحان شود.
علل شایع این خطا زمانی رخ می‌دهد که API به صورت داخلی با یک مشکل موقت مواجه شود.
نحوه رسیدگی هر درخواستی که با این خطا با شکست مواجه شده است را با استفاده از یک برنامه‌ی بازگشت نمایی برای تلاش‌های مجدد، دوباره امتحان کنید.
نکات پیشگیری ناموجود

InvalidGrantError

invalid_grant (malformed auth code)
خلاصه کد مجوزی که با توکن‌های OAuth مبادله شده بود، ناقص بود.
علل شایع این اتفاق هنگام تلاش برای تولید یک توکن به‌روزرسانی برای کاربری که قبلاً به برنامه درخواست‌کننده دسترسی داده شده است، رخ می‌دهد. برای مثال، این اتفاق می‌تواند هنگام اجرای بیش از یک بار مثال «ایجاد اعتبارنامه‌های کاربر» برای همان اعتبارنامه‌های کلاینت OAuth و تأیید اعتبار کاربر رخ دهد.
نحوه رسیدگی برای تولید مجدد یک توکن به‌روزرسانی برای ترکیبی از اعتبارنامه‌های کاربر مجاز و کلاینت OAuth، توکن به‌روزرسانی موجود را لغو کنید . توجه داشته باشید که لغو یک توکن، آن را برای دسترسی به API تبلیغات گوگل غیرقابل استفاده می‌کند و هرگونه توکن دسترسی که توکن به‌روزرسانی برای تولید آن استفاده شده است را باطل می‌کند.
نکات پیشگیری حتماً توکن به‌روزرسانی خود را در مکانی امن ذخیره کنید تا از نیاز به بازسازی آن جلوگیری شود.

MutateError

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

NotEmptyError

EMPTY_LIST
خلاصه یک لیست ضروری خالی است.
علل شایع ارسال یک لیست خالی از عملیات به یک متد mutate .
نحوه رسیدگی ناموجود
نکات پیشگیری ناموجود

QuotaError

RESOURCE_EXHAUSTED
خلاصه از حد فرکانس سیستم تجاوز شده است.
علل شایع ناموجود
نحوه رسیدگی ناموجود
نکات پیشگیری بین درخواست‌ها تأخیرهای کوتاه ایجاد کنید یا عملیات بیشتری را در تعداد درخواست‌های کمتری ترکیب کنید.

RangeError

TOO_LOW
خلاصه یک مقدار کمتر از حداقل مجاز بود.
علل شایع فراموش کردن تعیین شناسه، که منجر به ارسال مقدار 0 می‌شود.
نحوه رسیدگی ناموجود
نکات پیشگیری به هرگونه محدودیت دامنه که در مرجع API مستند شده است، توجه کنید.

RequestError

INVALID_INPUT
خلاصه درخواست ناقص است.
علل شایع آدرس اینترنتی یا محتوای درخواست ناقص است.
نحوه رسیدگی ناموجود
نکات پیشگیری ناموجود
REQUIRED_FIELD_MISSING
خلاصه درخواست فاقد اطلاعات مورد نیاز است.
علل شایع هنگام تلاش برای افزودن یک موجودیت، فیلدهای الزامی وجود ندارند.
نحوه رسیدگی خطا را ثبت کنید و یک پیام خطا به کاربر ارائه دهید. ویژگی fieldPath خطا نشان می‌دهد که کدام فیلد از قلم افتاده است.
نکات پیشگیری برای اطلاع از فیلدهای مورد نیاز، به مرجع API مراجعه کنید.

ResourceCountLimitExceededError

RESOURCE_LIMIT
خلاصه این درخواست در تلاش است منبعی ایجاد کند که باعث شود تعداد کل آن منابع از حد مشخصی فراتر رود.
علل شایع محدودیت‌های متعددی در تعداد منابعی که می‌توانند در زمینه‌های خاص وجود داشته باشند، وجود دارد.
نحوه رسیدگی با بررسی محدودیت‌های سیستم ، محدودیتی را که با آن مواجه هستید شناسایی کنید. یا از یک منبع موجود دوباره استفاده کنید، یا منابع را حذف کنید تا فضای بیشتری برای منابع جدید ایجاد شود.
نکات پیشگیری از کوئری‌های جستجو برای نظارت بر تعداد منابعی که محدودیت دارند استفاده کنید.

StringLengthError

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

قبلی
روش های دیگر
بعدی
مثال‌ها