خطاهای رایج

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

google.auth.exceptions.RefreshError

invalid_grant

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

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

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

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

AdGroupError

DUPLICATE_ADGROUP_NAME

خلاصه یک گروه تبلیغاتی در حال افزودن یا تغییر نام است، اما این نام در حال حاضر توسط گروه تبلیغاتی دیگری استفاده شده است. علل رایج ایجاد یک گروه تبلیغاتی جدید با نام یک گروه تبلیغاتی فعال یا متوقف شده موجود. نحوه رسیدگی خطا را ثبت کنید و یک پیام خطا به کاربر ارائه دهید، به صورت اختیاری یک نام گروه تبلیغاتی منحصر به فرد را پیشنهاد می کند یا لیست نام های در حال استفاده را نشان می دهد. نکات پیشگیری N/A

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

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	خلاصه شناسه مشتری مشتری یک عدد نیست. علل رایج استفاده از شناسه مشتری نامناسب نحوه رسیدگی N/A نکات پیشگیری 123-456-7890 باید 1234567890 باشد. برای جزئیات به شروع به کار مراجعه کنید.
CLIENT_CUSTOMER_ID_IS_REQUIRED	خلاصه شناسه مشتری مشتری در هدر HTTP مشخص نشده است. علل رایج عدم تعیین شناسه مشتری مشتری در هدر HTTP. نحوه رسیدگی N/A نکات پیشگیری شناسه مشتری مشتری برای همه تماس‌ها لازم است، بنابراین مطمئن شوید که در سربرگ HTTP یکی را مشخص کرده‌اید. استفاده از کتابخانه های مشتری ما را در نظر بگیرید زیرا آنها این کار را برای شما انجام می دهند.
CUSTOMER_NOT_FOUND	خلاصه هیچ حساب کاربری برای شناسه مشتری ارائه شده در هدر یافت نشد. علل رایج تلاش برای دسترسی به حسابی که به تازگی قبل از ایجاد حساب در backend ایجاد شده است. نحوه رسیدگی پنج دقیقه اولیه صبر کنید، سپس هر 30 ثانیه یکبار دوباره امتحان کنید. نکات پیشگیری چند دقیقه بعد از ایجاد حساب منتظر بمانید تا درخواستی علیه آن صادر کنید.
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 موجود دعوت کنید. نکات پیشگیری N/A
OAUTH_TOKEN_INVALID	خلاصه نشانه دسترسی OAuth در هدر معتبر نیست. علل رایج رمز دسترسی شما که با سرصفحه HTTP ارسال شده درست نبود. نحوه رسیدگی N/A نکات پیشگیری مطمئن شوید که رمز دسترسی صحیح مرتبط با حساب خود را ارسال کرده اید. گاهی اوقات با توکن های تازه سازی و کدهای مجوز اشتباه گرفته می شود. اگر می‌خواهید اعتبارنامه‌ای دریافت کنید که بتواند به همه حساب‌های مشتری تحت یک حساب مدیر دسترسی داشته باشد، مطمئن شوید که رمز تازه‌سازی حساب مدیر را دریافت کرده‌اید. برای جزئیات بیشتر، به راهنمای ما در مورد نشانه دسترسی و رمز بازخوانی و OAuth2 مراجعه کنید.

AuthorizationError
CUSTOMER_NOT_ENABLED	خلاصه دسترسی به حساب مشتری امکان پذیر نیست زیرا در حالت فعال نیست. علل رایج این زمانی اتفاق می‌افتد که حساب مشتری ثبت‌نام را تمام نکرده یا غیرفعال شده باشد. نحوه رسیدگی وارد رابط کاربری Google Ads شوید و مطمئن شوید که فرآیند ثبت نام برای این حساب را تکمیل کرده اید. برای حساب‌های غیرفعال‌شده، به فعال‌سازی مجدد حساب لغو شده Google Ads مراجعه کنید. نکات پیشگیری با بررسی وضعیت لغو شده ، می‌توانید فعالانه بررسی کنید که آیا حساب مشتری غیرفعال شده است.
DEVELOPER_TOKEN_NOT_APPROVED	خلاصه توکن توسعه‌دهنده فقط برای استفاده با حساب‌های آزمایشی تأیید شده است و سعی شده به یک حساب غیر آزمایشی دسترسی پیدا کند. علل رایج برای دسترسی به یک حساب غیر آزمایشی از یک توکن توسعه دهنده آزمایشی استفاده شد. نحوه رسیدگی مطمئن شوید که واقعاً می خواهید به یک حساب غیر آزمایشی دسترسی داشته باشید. اگر چنین است، پس باید برای ارتقای توکن توسعه دهنده خود به دسترسی استاندارد یا پایه اقدام کنید . نکات پیشگیری N/A
DEVELOPER_TOKEN_PROHIBITED	خلاصه توکن توسعه دهنده با پروژه ارسال شده در درخواست مجاز نیست. علل رایج هر پروژه Google API Console را می توان با توکن توسعه دهنده تنها از یک حساب مدیر مرتبط کرد. هنگامی که یک درخواست Google Ads API ارائه می کنید، توکن توسعه دهنده به طور دائم با پروژه Google API Console جفت می شود. اگر از پروژه Google API Console جدید استفاده نکنید، هنگام درخواست با خطای DEVELOPER_TOKEN_PROHIBITED مواجه خواهید شد. نحوه رسیدگی N/A نکات پیشگیری اگر تحت یک حساب مدیر جدید به کد برنامه‌نویس تغییر دهید، باید یک پروژه کنسول API Google جدید برای درخواست‌های Google Ads API ایجاد کنید که از نشانه مدیر جدید استفاده می‌کنند.
USER_PERMISSION_DENIED	خلاصه مشتری مجاز به مشتری عامل دسترسی ندارد. علل رایج احراز هویت به عنوان یک کاربر با دسترسی به حساب مدیر، اما عدم تعیین login-customer-id در درخواست. نحوه رسیدگی N/A نکات پیشگیری شناسه login-customer-id به عنوان شناسه حساب مدیر بدون خط تیره ( - ) مشخص کنید. کتابخانه های مشتری برای این کار پشتیبانی کرده اند.

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

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

CampaignError
DUPLICATE_CAMPAIGN_NAME	خلاصه یک کمپین در حال اضافه شدن یا تغییر نام است، اما نام در حال حاضر توسط یک کمپین دیگر استفاده شده است. علل رایج ایجاد یک کمپین جدید با نام یک کمپین فعال یا متوقف شده موجود. نحوه رسیدگی خطا را ثبت کنید و یک پیام خطا به کاربر ارائه دهید، که به صورت اختیاری یک نام کمپین منحصر به فرد را پیشنهاد می کند یا لیست نام های در حال استفاده را نشان می دهد. نکات پیشگیری N/A

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

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

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

InvalidGrantError

invalid_grant (malformed auth code)

خلاصه کد مجوز مبادله شده با نشانه‌های OAuth نادرست بود. علل رایج این زمانی اتفاق می‌افتد که سعی می‌کنید یک نشانه تازه‌سازی برای کاربری ایجاد کنید که قبلاً به برنامه درخواست‌کننده دسترسی داشته است. به عنوان مثال، زمانی که مثال Generate User credentials را بیش از یک بار برای همان اعتبار مشتری OAuth اجرا کنید و کاربر را مجاز کنید، این اتفاق می افتد. نحوه رسیدگی به منظور ایجاد مجدد یک نشانه تازه‌سازی برای ترکیبی از مجوزهای کاربر مجاز و اعتبار مشتری OAuth، یک نشانه تازه‌سازی موجود را لغو کنید . توجه داشته باشید که باطل کردن یک نشانه، آن را برای دسترسی به API Google Ads غیرقابل استفاده می کند و هر گونه نشانه دسترسی را که از توکن تازه سازی برای تولید استفاده شده است، بی اعتبار می کند. نکات پیشگیری اطمینان حاصل کنید که رمز به‌روزرسانی خود را در مکانی امن ذخیره می‌کنید تا از نیاز به بازسازی جلوگیری کنید.

MutateError

RESOURCE_NOT_FOUND

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

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

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

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

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

ResourceCountLimitExceededError

RESOURCE_LIMIT

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

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

،

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

google.auth.exceptions.RefreshError

invalid_grant

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

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

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

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

AdGroupError

DUPLICATE_ADGROUP_NAME

خلاصه یک گروه تبلیغاتی در حال افزودن یا تغییر نام است، اما این نام در حال حاضر توسط گروه تبلیغاتی دیگری استفاده شده است. علل رایج ایجاد یک گروه تبلیغاتی جدید با نام یک گروه تبلیغاتی فعال یا متوقف شده موجود. نحوه رسیدگی خطا را ثبت کنید و یک پیام خطا به کاربر ارائه دهید، به صورت اختیاری یک نام گروه تبلیغاتی منحصر به فرد را پیشنهاد می کند یا لیست نام های در حال استفاده را نشان می دهد. نکات پیشگیری N/A

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

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	خلاصه شناسه مشتری مشتری یک عدد نیست. علل رایج استفاده از شناسه مشتری نامناسب نحوه رسیدگی N/A نکات پیشگیری 123-456-7890 باید 1234567890 باشد. برای جزئیات به شروع به کار مراجعه کنید.
CLIENT_CUSTOMER_ID_IS_REQUIRED	خلاصه شناسه مشتری مشتری در هدر HTTP مشخص نشده است. علل رایج عدم تعیین شناسه مشتری مشتری در هدر HTTP. نحوه رسیدگی N/A نکات پیشگیری شناسه مشتری مشتری برای همه تماس‌ها لازم است، بنابراین مطمئن شوید که در سربرگ HTTP یکی را مشخص کرده‌اید. استفاده از کتابخانه های مشتری ما را در نظر بگیرید زیرا آنها این کار را برای شما انجام می دهند.
CUSTOMER_NOT_FOUND	خلاصه هیچ حساب کاربری برای شناسه مشتری ارائه شده در هدر یافت نشد. علل رایج تلاش برای دسترسی به حسابی که به تازگی قبل از ایجاد حساب در backend ایجاد شده است. نحوه رسیدگی پنج دقیقه اولیه صبر کنید، سپس هر 30 ثانیه یکبار دوباره امتحان کنید. نکات پیشگیری چند دقیقه بعد از ایجاد حساب منتظر بمانید تا درخواستی علیه آن صادر کنید.
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 موجود دعوت کنید. نکات پیشگیری N/A
OAUTH_TOKEN_INVALID	خلاصه نشانه دسترسی OAuth در هدر معتبر نیست. علل رایج رمز دسترسی شما که با سرصفحه HTTP ارسال شده درست نبود. نحوه رسیدگی N/A نکات پیشگیری مطمئن شوید که رمز دسترسی صحیح مرتبط با حساب خود را ارسال کرده اید. گاهی اوقات با توکن های تازه سازی و کدهای مجوز اشتباه گرفته می شود. اگر می‌خواهید اعتبارنامه‌ای دریافت کنید که بتواند به همه حساب‌های مشتری تحت یک حساب مدیر دسترسی داشته باشد، مطمئن شوید که رمز تازه‌سازی حساب مدیر را دریافت کرده‌اید. برای جزئیات بیشتر، به راهنمای ما در مورد نشانه دسترسی و رمز بازخوانی و OAuth2 مراجعه کنید.

AuthorizationError
CUSTOMER_NOT_ENABLED	خلاصه دسترسی به حساب مشتری امکان پذیر نیست زیرا در حالت فعال نیست. علل رایج این زمانی اتفاق می‌افتد که حساب مشتری ثبت‌نام را تمام نکرده یا غیرفعال شده باشد. نحوه رسیدگی وارد رابط کاربری Google Ads شوید و مطمئن شوید که فرآیند ثبت نام برای این حساب را تکمیل کرده اید. برای حساب‌های غیرفعال‌شده، به فعال‌سازی مجدد حساب لغو شده Google Ads مراجعه کنید. نکات پیشگیری با بررسی وضعیت لغو شده ، می‌توانید فعالانه بررسی کنید که آیا حساب مشتری غیرفعال شده است.
DEVELOPER_TOKEN_NOT_APPROVED	خلاصه توکن توسعه‌دهنده فقط برای استفاده با حساب‌های آزمایشی تأیید شده است و سعی شده به یک حساب غیر آزمایشی دسترسی پیدا کند. علل رایج برای دسترسی به یک حساب غیر آزمایشی از یک توکن توسعه دهنده آزمایشی استفاده شد. نحوه رسیدگی مطمئن شوید که واقعاً می خواهید به یک حساب غیر آزمایشی دسترسی داشته باشید. اگر چنین است، پس باید برای ارتقای توکن توسعه دهنده خود به دسترسی استاندارد یا پایه اقدام کنید . نکات پیشگیری N/A
DEVELOPER_TOKEN_PROHIBITED	خلاصه توکن توسعه دهنده با پروژه ارسال شده در درخواست مجاز نیست. علل رایج هر پروژه Google API Console را می توان با توکن توسعه دهنده تنها از یک حساب مدیر مرتبط کرد. هنگامی که یک درخواست Google Ads API ارائه می کنید، توکن توسعه دهنده به طور دائم با پروژه Google API Console جفت می شود. اگر از پروژه Google API Console جدید استفاده نکنید، هنگام درخواست با خطای DEVELOPER_TOKEN_PROHIBITED مواجه خواهید شد. نحوه رسیدگی N/A نکات پیشگیری اگر تحت یک حساب مدیر جدید به کد برنامه‌نویس تغییر دهید، باید یک پروژه کنسول API Google جدید برای درخواست‌های Google Ads API ایجاد کنید که از نشانه مدیر جدید استفاده می‌کنند.
USER_PERMISSION_DENIED	خلاصه مشتری مجاز به مشتری عامل دسترسی ندارد. علل رایج احراز هویت به عنوان یک کاربر با دسترسی به حساب مدیر، اما عدم تعیین login-customer-id در درخواست. نحوه رسیدگی N/A نکات پیشگیری شناسه login-customer-id به عنوان شناسه حساب مدیر بدون خط تیره ( - ) مشخص کنید. کتابخانه های مشتری برای این کار پشتیبانی کرده اند.

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

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

CampaignError
DUPLICATE_CAMPAIGN_NAME	خلاصه یک کمپین در حال اضافه شدن یا تغییر نام است، اما نام در حال حاضر توسط یک کمپین دیگر استفاده شده است. علل رایج ایجاد یک کمپین جدید با نام یک کمپین فعال یا متوقف شده موجود. نحوه رسیدگی خطا را ثبت کنید و یک پیام خطا به کاربر ارائه دهید، که به صورت اختیاری یک نام کمپین منحصر به فرد را پیشنهاد می کند یا لیست نام های در حال استفاده را نشان می دهد. نکات پیشگیری N/A

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

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

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

InvalidGrantError

invalid_grant (malformed auth code)

خلاصه کد مجوز مبادله شده با نشانه‌های OAuth نادرست بود. علل رایج این زمانی اتفاق می‌افتد که سعی می‌کنید یک نشانه تازه‌سازی برای کاربری ایجاد کنید که قبلاً به برنامه درخواست‌کننده دسترسی داشته است. به عنوان مثال، زمانی که مثال Generate User credentials را بیش از یک بار برای همان اعتبار مشتری OAuth اجرا کنید و کاربر را مجاز کنید، این اتفاق می افتد. نحوه رسیدگی به منظور ایجاد مجدد یک نشانه تازه‌سازی برای ترکیبی از مجوزهای کاربر مجاز و اعتبار مشتری OAuth، یک نشانه تازه‌سازی موجود را لغو کنید . توجه داشته باشید که باطل کردن یک نشانه، آن را برای دسترسی به API Google Ads غیرقابل استفاده می کند و هر گونه نشانه دسترسی را که از توکن تازه سازی برای تولید استفاده شده است، بی اعتبار می کند. نکات پیشگیری اطمینان حاصل کنید که رمز به‌روزرسانی خود را در مکانی امن ذخیره می‌کنید تا از نیاز به بازسازی جلوگیری کنید.

MutateError

RESOURCE_NOT_FOUND

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

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

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

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

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

ResourceCountLimitExceededError

RESOURCE_LIMIT

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

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

،

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

google.auth.exceptions.RefreshError

invalid_grant

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

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

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

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

AdGroupError

DUPLICATE_ADGROUP_NAME

خلاصه یک گروه تبلیغاتی در حال افزودن یا تغییر نام است، اما این نام در حال حاضر توسط گروه تبلیغاتی دیگری استفاده شده است. علل رایج ایجاد یک گروه تبلیغاتی جدید با نام یک گروه تبلیغاتی فعال یا متوقف شده موجود. نحوه رسیدگی خطا را ثبت کنید و یک پیام خطا به کاربر ارائه دهید، به صورت اختیاری یک نام گروه تبلیغاتی منحصر به فرد را پیشنهاد می کند یا لیست نام های در حال استفاده را نشان می دهد. نکات پیشگیری N/A

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

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	خلاصه شناسه مشتری مشتری یک عدد نیست. علل رایج استفاده از شناسه مشتری نامناسب نحوه رسیدگی N/A نکات پیشگیری 123-456-7890 باید 1234567890 باشد. برای جزئیات به شروع به کار مراجعه کنید.
CLIENT_CUSTOMER_ID_IS_REQUIRED	خلاصه شناسه مشتری مشتری در هدر HTTP مشخص نشده است. علل رایج عدم تعیین شناسه مشتری مشتری در هدر HTTP. نحوه رسیدگی N/A نکات پیشگیری شناسه مشتری مشتری برای همه تماس‌ها لازم است، بنابراین مطمئن شوید که در سربرگ HTTP یکی را مشخص کرده‌اید. استفاده از کتابخانه های مشتری ما را در نظر بگیرید زیرا آنها این کار را برای شما انجام می دهند.
CUSTOMER_NOT_FOUND	خلاصه هیچ حساب کاربری برای شناسه مشتری ارائه شده در هدر یافت نشد. علل رایج تلاش برای دسترسی به حسابی که به تازگی قبل از ایجاد حساب در backend ایجاد شده است. نحوه رسیدگی پنج دقیقه اولیه صبر کنید، سپس هر 30 ثانیه یکبار دوباره امتحان کنید. نکات پیشگیری چند دقیقه بعد از ایجاد حساب منتظر بمانید تا درخواستی علیه آن صادر کنید.
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 موجود دعوت کنید. نکات پیشگیری N/A
OAUTH_TOKEN_INVALID	خلاصه نشانه دسترسی OAuth در هدر معتبر نیست. علل رایج رمز دسترسی شما که با سرصفحه HTTP ارسال شده درست نبود. نحوه رسیدگی N/A نکات پیشگیری مطمئن شوید که رمز دسترسی صحیح مرتبط با حساب خود را ارسال کرده اید. گاهی اوقات با توکن های تازه سازی و کدهای مجوز اشتباه گرفته می شود. اگر می‌خواهید اعتبارنامه‌ای دریافت کنید که بتواند به همه حساب‌های مشتری تحت یک حساب مدیر دسترسی داشته باشد، مطمئن شوید که رمز تازه‌سازی حساب مدیر را دریافت کرده‌اید. برای جزئیات بیشتر، به راهنمای ما در مورد نشانه دسترسی و رمز بازخوانی و OAuth2 مراجعه کنید.

AuthorizationError
CUSTOMER_NOT_ENABLED	خلاصه دسترسی به حساب مشتری امکان پذیر نیست زیرا در حالت فعال نیست. علل رایج این زمانی اتفاق می‌افتد که حساب مشتری ثبت‌نام را تمام نکرده یا غیرفعال شده باشد. نحوه رسیدگی وارد رابط کاربری Google Ads شوید و مطمئن شوید که فرآیند ثبت نام برای این حساب را تکمیل کرده اید. برای حساب‌های غیرفعال‌شده، به فعال‌سازی مجدد حساب لغو شده Google Ads مراجعه کنید. نکات پیشگیری با بررسی وضعیت لغو شده ، می‌توانید فعالانه بررسی کنید که آیا حساب مشتری غیرفعال شده است.
DEVELOPER_TOKEN_NOT_APPROVED	خلاصه توکن توسعه‌دهنده فقط برای استفاده با حساب‌های آزمایشی تأیید شده است و سعی شده به یک حساب غیر آزمایشی دسترسی پیدا کند. علل رایج برای دسترسی به یک حساب غیر آزمایشی از یک توکن توسعه دهنده آزمایشی استفاده شد. نحوه رسیدگی مطمئن شوید که واقعاً می خواهید به یک حساب غیر آزمایشی دسترسی داشته باشید. اگر چنین است، پس باید برای ارتقای توکن توسعه دهنده خود به دسترسی استاندارد یا پایه اقدام کنید . نکات پیشگیری N/A
DEVELOPER_TOKEN_PROHIBITED	خلاصه توکن توسعه دهنده با پروژه ارسال شده در درخواست مجاز نیست. علل رایج هر پروژه Google API Console را می توان با توکن توسعه دهنده تنها از یک حساب مدیر مرتبط کرد. هنگامی که یک درخواست Google Ads API ارائه می کنید، توکن توسعه دهنده به طور دائم با پروژه Google API Console جفت می شود. اگر از پروژه Google API Console جدید استفاده نکنید، هنگام درخواست با خطای DEVELOPER_TOKEN_PROHIBITED مواجه خواهید شد. نحوه رسیدگی N/A نکات پیشگیری اگر تحت یک حساب مدیر جدید به کد برنامه‌نویس تغییر دهید، باید یک پروژه کنسول API Google جدید برای درخواست‌های Google Ads API ایجاد کنید که از نشانه مدیر جدید استفاده می‌کنند.
USER_PERMISSION_DENIED	خلاصه مشتری مجاز به مشتری عامل دسترسی ندارد. علل رایج احراز هویت به عنوان یک کاربر با دسترسی به حساب مدیر، اما عدم تعیین login-customer-id در درخواست. نحوه رسیدگی N/A نکات پیشگیری شناسه login-customer-id به عنوان شناسه حساب مدیر بدون خط تیره ( - ) مشخص کنید. کتابخانه های مشتری برای این کار پشتیبانی کرده اند.

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

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

CampaignError
DUPLICATE_CAMPAIGN_NAME	خلاصه یک کمپین در حال اضافه شدن یا تغییر نام است، اما نام در حال حاضر توسط یک کمپین دیگر استفاده شده است. علل رایج ایجاد یک کمپین جدید با نام یک کمپین فعال یا متوقف شده موجود. نحوه رسیدگی خطا را ثبت کنید و یک پیام خطا به کاربر ارائه دهید، که به صورت اختیاری یک نام کمپین منحصر به فرد را پیشنهاد می کند یا لیست نام های در حال استفاده را نشان می دهد. نکات پیشگیری N/A

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

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

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

InvalidGrantError

invalid_grant (malformed auth code)

خلاصه کد مجوز مبادله شده برای نشانه های OAuth ناقص شد. علل رایج این اتفاق در هنگام تلاش برای ایجاد یک نشانه تازه برای کاربر که قبلاً دسترسی به برنامه درخواست کننده داده شده است ، اتفاق می افتد. به عنوان مثال ، این می تواند در هنگام اجرای نمونه اعتبار کاربر تولید بیش از یک بار برای همان اعتبار مشتری OAuth و مجوز کاربر اتفاق بیفتد. نحوه رسیدگی به منظور بازسازی یک نشانه تازه سازی برای ترکیبی از مجوز اعتبار کاربر و مشتری OAUTH ، یک نشانه تازه سازی موجود را لغو کنید . توجه داشته باشید که ابطال یک نشانه ، آن را برای دسترسی به API Google ADS غیر قابل استفاده می کند و هرگونه نشانه دسترسی را که از نشانه های تازه برای تولید استفاده شده است ، بی اعتبار می کند. نکات پیشگیری برای جلوگیری از نیاز به بازسازی ، حتماً نشانه تازه سازی خود را در یک مکان امن ذخیره کنید.

MutateError

RESOURCE_NOT_FOUND

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

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

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

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

RequestError
INVALID_INPUT	خلاصه درخواست ناقص است. علل رایج URL یا محتوای درخواست ناقص است. نحوه رسیدگی N/A نکات پیشگیری N/A
REQUIRED_FIELD_MISSING	خلاصه درخواست اطلاعات لازم را از دست نمی دهد. علل رایج در هنگام تلاش برای اضافه کردن یک موجود ، زمینه های مورد نیاز از دست رفته است. نحوه رسیدگی خطا را وارد کنید و یک پیام خطا را به کاربر ارائه دهید. ویژگی fieldPath خطا نشان می دهد که کدام قسمت از دست رفته است. نکات پیشگیری برای یافتن اینکه کدام قسمت ها مورد نیاز است ، به مرجع API مراجعه کنید.

ResourceCountLimitExceededError

RESOURCE_LIMIT

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

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

،

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

google.auth.exceptions.RefreshError

invalid_grant

خلاصه توکن منقضی شده یا ابطال شده است. علل رایج یک پروژه Google Cloud Platform با یک صفحه رضایت OAUTH که برای یک نوع کاربر خارجی پیکربندی شده است و وضعیت انتشار Testing در 7 روز یک نشانه تازه سازی صادر می شود. نحوه رسیدگی وضعیت انتشار پروژه Google شما در Testing است ، بنابراین نشانه تازه سازی هر 7 روز یکبار منقضی می شود و یک خطای invalid_grant دریافت می کند. به کنسول Google API بروید و به صفحه رضایت OAuth بروید. سپس وضعیت انتشار را به دنبال این In production ها تغییر دهید تا از انقضاء تازه در 7 روز جلوگیری شود. نکات پیشگیری به برنامه های تأیید نشده مراجعه کنید.

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	خلاصه این اپراتور با یک زیر کلاس AD قابل استفاده نیست. علل رایج تلاش برای اصلاح ویژگی های غیر از status تبلیغ. نحوه رسیدگی N/A نکات پیشگیری پس از ایجاد یک آگهی ، قابل تغییر نیست. اگر می خواهید تبلیغ را اصلاح کنید ، باید یک تبلیغ جدید تهیه کرده و سپس قدیمی را حذف کنید. با این حال ، status AD با استفاده از mutateadgroupads قابل اصلاح است.
INVALID_INPUT	خلاصه یکی از زمینه های موجود در یک آگهی دارای شخصیت های نامعتبر است. علل رایج با استفاده از شخصیت های خاص در URL. نحوه رسیدگی N/A نکات پیشگیری قبل از درخواست API ، URL ها را در برنامه خود تأیید کنید.
LINE_TOO_WIDE	خلاصه یکی از زمینه های یک آگهی طولانی تر از حداکثر طول مجاز بود. در مورد تبلیغات متنی مشاهده کنید. علل رایج داشتن خیلی طولانی از یک خط متن. نحوه رسیدگی N/A نکات پیشگیری قبل از درخواست API ، طول خط را تأیید کنید.

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

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

AdGroupError
DUPLICATE_ADGROUP_NAME	خلاصه یک گروه تبلیغاتی در حال اضافه شدن یا تغییر نام است ، اما این نام در حال حاضر توسط گروه تبلیغاتی دیگری استفاده می شود. علل رایج ایجاد یک گروه تبلیغاتی جدید با نام یک گروه تبلیغاتی فعال یا مکث موجود. نحوه رسیدگی خطا را وارد کنید و یک پیام خطا را به کاربر ارائه دهید ، به طور اختیاری یک نام گروه تبلیغی منحصر به فرد را نشان می دهد یا لیست نام های مورد استفاده را نشان می دهد. نکات پیشگیری N/A

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

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	خلاصه شناسه مشتری مشتری شماره ای نیست. علل رایج با استفاده از شناسه مشتری نامناسب مشتری. نحوه رسیدگی N/A نکات پیشگیری 123-456-7890 باید 1234567890 باشد. برای جزئیات بیشتر شروع کنید .
CLIENT_CUSTOMER_ID_IS_REQUIRED	خلاصه شناسه مشتری مشتری در عنوان HTTP مشخص نشده است. علل رایج مشخص کردن شناسه مشتری مشتری در عنوان HTTP. نحوه رسیدگی N/A نکات پیشگیری شناسه مشتری مشتری برای همه تماس ها لازم است ، بنابراین مطمئن شوید که یکی را در هدر HTTP مشخص کرده اید. در نظر بگیرید که از کتابخانه های مشتری ما استفاده کنید زیرا آنها این کار را برای شما انجام می دهند.
CUSTOMER_NOT_FOUND	خلاصه هیچ حساب کاربری برای شناسه مشتری ارائه شده در هدر یافت نمی شود. علل رایج تلاش برای دسترسی به حسابی که تازه قبل از ایجاد حساب در پس زمینه ایجاد شده است. نحوه رسیدگی پنج دقیقه اولیه صبر کنید ، سپس هر 30 ثانیه دوباره امتحان کنید. نکات پیشگیری چند دقیقه پس از ایجاد حساب قبل از صدور درخواست علیه آن صبر کنید.
GOOGLE_ACCOUNT_COOKIE_INVALID	خلاصه نشانه دسترسی در عنوان درخواست یا نامعتبر است یا منقضی شده است. علل رایج نشانه دسترسی باطل شده است. نحوه رسیدگی درخواست یک نشانه جدید. اگر از یکی از کتابخانه های مشتری ما استفاده می کنید ، در مورد نحوه تازه کردن نشانه ، با مستندات آن مشورت کنید. نکات پیشگیری تا زمانی که منقضی شوند ، از نشانه های دسترسی استفاده و استفاده مجدد کنید.
NOT_ADS_USER	خلاصه حساب Google که برای تولید نشانه دسترسی استفاده می شود با هیچ حساب تبلیغاتی Google همراه نیست. علل رایج اطلاعات ورود به سیستم مربوط به یک حساب Google است که تبلیغات Google را فعال نمی کند. نحوه رسیدگی برای جریان OAUTH حتماً با یک حساب معتبر Google ADS (به طور معمول حساب مدیر خود) وارد شوید. همچنین می توانید با ورود به حساب مدیر خود ، انتخاب حساب مشتری یا مدیر مورد نظر ، حرکت به یک حساب کاربری Google Ads ، حساب Google را برای دسترسی به یک حساب کاربری Google ADS ، انتخاب کنید و به Tools and Settings > Access and security بپردازید و سپس آدرس ایمیل حساب Google را اضافه کنید. نکات پیشگیری N/A
OAUTH_TOKEN_INVALID	خلاصه نشانه دسترسی OAUTH در هدر معتبر نیست. علل رایج نشانه دسترسی شما با عنوان HTTP تصویب شد. نحوه رسیدگی N/A نکات پیشگیری اطمینان حاصل کنید که نشانه دسترسی صحیح مرتبط با حساب خود را منتقل کرده اید. گاهی اوقات با نشانه های تازه سازی و کدهای مجوز اشتباه گرفته می شود. اگر می خواهید یک اعتبار دریافت کنید که بتواند به همه حساب های مشتری تحت یک حساب مدیر دسترسی پیدا کند ، حتماً نشانه Refresh را برای حساب مدیر دریافت کنید. برای اطلاعات بیشتر ، به راهنمای ما در مورد نشانه دسترسی و Token و OAUTH2 مراجعه کنید.

AuthorizationError
CUSTOMER_NOT_ENABLED	خلاصه به حساب مشتری نمی توان دسترسی پیدا کرد زیرا در حالت فعال نیست. علل رایج این زمانی اتفاق می افتد که حساب مشتری ثبت نام را تمام نکرده یا غیرفعال شده است. نحوه رسیدگی وارد UI ADS Google شوید و اطمینان حاصل کنید که روند ثبت نام این حساب را انجام داده اید. برای حسابهای غیرفعال شده ، به یک حساب تبلیغاتی Google ADS دوباره فعال کنید . نکات پیشگیری می توانید با بررسی وضعیت لغو ، یک حساب مشتری غیرفعال شود.
DEVELOPER_TOKEN_NOT_APPROVED	خلاصه توکن توسعه دهنده فقط برای استفاده با حساب های آزمون تأیید شده و سعی در دسترسی به یک حساب غیر آزمون دارد. علل رایج برای دسترسی به یک حساب غیر آزمون از یک نشانه توسعه دهنده آزمایش استفاده شد. نحوه رسیدگی اطمینان حاصل کنید که در واقع می خواهید به یک حساب غیر آزمون دسترسی پیدا کنید. اگر چنین است ، پس باید درخواست کنید تا توکن توسعه دهنده خود به دسترسی استاندارد یا اساسی ارتقا یابد . نکات پیشگیری N/A
DEVELOPER_TOKEN_PROHIBITED	خلاصه توکن توسعه دهنده با پروژه ارسال شده در درخواست مجاز نیست. علل رایج هر پروژه کنسول Google API می تواند تنها از یک حساب مدیر با توکن توسعه دهنده همراه باشد. هنگامی که یک درخواست API Google ADS ایجاد کردید ، توکن توسعه دهنده به طور دائم در پروژه کنسول Google API جفت می شود. اگر از یک پروژه جدید کنسول Google API استفاده نکنید ، هنگام درخواست یک خطای DEVELOPER_TOKEN_PROHIBITED دریافت خواهید کرد. نحوه رسیدگی N/A نکات پیشگیری در صورت جابجایی به یک توکن توسعه دهنده تحت یک حساب مدیر جدید ، باید یک پروژه جدید کنسول Google API را برای درخواست های Google Ads API که از نشانه مدیر جدید استفاده می کنند ، ایجاد کنید .
USER_PERMISSION_DENIED	خلاصه مشتری مجاز به مشتری عملیاتی دسترسی ندارد. علل رایج تأیید اعتبار به عنوان کاربر با دسترسی به یک حساب مدیر اما مشخص کردن login-customer-id در درخواست. نحوه رسیدگی N/A نکات پیشگیری login-customer-id به عنوان شناسه حساب مدیر بدون Hyphens ( - ) مشخص کنید. کتابخانه های مشتری در پشتیبانی از این امر ساخته شده اند.

BiddingError
BID_TOO_MANY_FRACTIONAL_DIGITS	خلاصه مقدار پیشنهاد چند برابر دقیق از حداقل واحد ارز حساب نیست. به عنوان مثال ، 0.015 دلار آمریکا ( 15000 در میکرو) یک پیشنهاد معتبر نیست. علل رایج N/A نحوه رسیدگی N/A نکات پیشگیری تأیید کنید که پیشنهادات چند برابر واحد برای ارز حساب هستند.
BID_TOO_BIG	خلاصه این خطا بازگردانده می شود حتی اگر پیشنهاد در بودجه کمپین باشد. علل مشترک N/A نحوه رسیدگی N/A نکات پیشگیری بررسی کنید که آیا این حساب در کمک های مالی Google AD شرکت کرده است یا خیر. در این صورت ، پیشنهادات CPC را به حداکثر تعیین شده توسط برنامه محدود کنید.

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

CampaignError
DUPLICATE_CAMPAIGN_NAME	خلاصه یک کمپین در حال اضافه شدن یا تغییر نام است ، اما این نام در حال حاضر توسط یک کمپین دیگر استفاده می شود. علل مشترک ایجاد یک کمپین جدید با نام یک کمپین فعال یا مکث موجود. نحوه رسیدگی خطا را وارد کنید و یک پیام خطا را به کاربر ارائه دهید ، به طور اختیاری یک نام کمپین منحصر به فرد را نشان می دهد یا لیست نام های مورد استفاده را نشان می دهد. نکات پیشگیری N/A

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

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

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

InvalidGrantError

invalid_grant (malformed auth code)

خلاصه کد مجوز مبادله شده برای نشانه های OAuth ناقص شد. علل رایج این اتفاق در هنگام تلاش برای ایجاد یک نشانه تازه برای کاربر که قبلاً دسترسی به برنامه درخواست کننده داده شده است ، اتفاق می افتد. به عنوان مثال ، این می تواند در هنگام اجرای نمونه اعتبار کاربر تولید بیش از یک بار برای همان اعتبار مشتری OAuth و مجوز کاربر اتفاق بیفتد. نحوه رسیدگی به منظور بازسازی یک نشانه تازه سازی برای ترکیبی از مجوز اعتبار کاربر و مشتری OAUTH ، یک نشانه تازه سازی موجود را لغو کنید . توجه داشته باشید که ابطال یک نشانه ، آن را برای دسترسی به API Google ADS غیر قابل استفاده می کند و هرگونه نشانه دسترسی را که از نشانه های تازه برای تولید استفاده شده است ، بی اعتبار می کند. نکات پیشگیری برای جلوگیری از نیاز به بازسازی ، حتماً نشانه تازه سازی خود را در یک مکان امن ذخیره کنید.

MutateError

RESOURCE_NOT_FOUND

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

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

QuotaError
RESOURCE_EXHAUSTED	خلاصه از حد فرکانس سیستم فراتر رفته است. علل مشترک N/A نحوه رسیدگی N/A نکات پیشگیری تأخیرهای کوتاه را بین درخواست ها تنظیم کنید یا عملیات بیشتری را در درخواست های کمتری ترکیب کنید.

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

RequestError
INVALID_INPUT	خلاصه درخواست ناقص است. علل مشترک URL یا محتوای درخواست ناقص است. نحوه رسیدگی N/A نکات پیشگیری N/A
REQUIRED_FIELD_MISSING	خلاصه درخواست اطلاعات لازم را از دست نمی دهد. علل مشترک در هنگام تلاش برای اضافه کردن یک موجود ، زمینه های مورد نیاز از دست رفته است. نحوه رسیدگی خطا را وارد کنید و یک پیام خطا را به کاربر ارائه دهید. ویژگی fieldPath خطا نشان می دهد که کدام قسمت از دست رفته است. نکات پیشگیری برای یافتن اینکه کدام قسمت ها مورد نیاز است ، به مرجع API مراجعه کنید.

ResourceCountLimitExceededError

RESOURCE_LIMIT

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

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