خطاهای رایج
این صفحه خطاهای رایج را فهرست می کند و نکاتی در مورد پیشگیری و مدیریت آنها ارائه می دهد. برای فهرست کامل خطاها، مراجع خطا را مرور کنید. برای حمایت بیشتر، از انجمن ما دیدن کنید.
google.auth.exceptions.RefreshError |
---|
invalid_grant | خلاصه | توکن منقضی شده یا باطل شده است. |
---|
علل رایج | یک پروژه Google Cloud Platform با صفحه رضایت OAuth که برای نوع کاربر خارجی پیکربندی شده است و وضعیت انتشار Testing یک نشانه بهروزرسانی صادر میکند که طی 7 روز منقضی میشود. |
---|
نحوه رسیدگی | وضعیت انتشار پروژه Google شما در Testing است، بنابراین رمز بهروزرسانی هر ۷ روز منقضی میشود و یک خطای invalid_grant دریافت میکند. به کنسول API Google بروید و به صفحه رضایت OAuth بروید. سپس وضعیت انتشار را با پیروی از این دستورالعملها به In production تغییر دهید تا از انقضای توکن بهروزرسانی در ۷ روز جلوگیری کنید. |
---|
نکات پیشگیری | برنامههای تأیید نشده را ببینید. |
---|
|
|
---|
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، طول خط را تأیید کنید. |
---|
|
|
---|
AD_GROUP_AD_LABEL_ALREADY_EXISTS | خلاصه | این برچسب قبلاً با برخی از تبلیغات مرتبط است. |
---|
علل رایج | تلاش برای مرتبط کردن برچسب با تبلیغاتی که قبلاً مرتبط شده اند. |
---|
نحوه رسیدگی | N/A |
---|
نکات پیشگیری | ابتدا بررسی کنید که آیا برچسبی که قرار است اضافه شود قبلاً با تبلیغات مرتبط است یا خیر. |
---|
|
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD | خلاصه | عملیاتی برای بهروزرسانی آگهی حذفشده تلاش کرد. |
---|
علل رایج | پس از حذف آگهی، دیگر نمی توان آن را به روز کرد - از جمله تغییرات در وضعیت آن. |
---|
نحوه رسیدگی | N/A |
---|
نکات پیشگیری | اطمینان حاصل کنید که کد شما سعی در به روز رسانی تبلیغات حذف شده ندارد. |
---|
|
|
---|
INVALID_KEYWORD_TEXT | خلاصه | متن کلمه کلیدی حاوی کاراکترهای نامعتبر است. به افزودن کلمات کلیدی مراجعه کنید. |
---|
علل رایج | متن کلمه کلیدی حاوی کاراکترهای نامعتبر است. |
---|
نحوه رسیدگی | N/A |
---|
نکات پیشگیری | قبل از درخواست به API، متن کلمه کلیدی را در برنامه خود اعتبارسنجی کنید. |
---|
|
|
---|
DUPLICATE_ADGROUP_NAME | خلاصه | یک گروه تبلیغاتی در حال افزودن یا تغییر نام است، اما این نام در حال حاضر توسط گروه تبلیغاتی دیگری استفاده شده است. |
---|
علل رایج | ایجاد یک گروه تبلیغاتی جدید با نام یک گروه تبلیغاتی فعال یا متوقف شده موجود. |
---|
نحوه رسیدگی | خطا را ثبت کنید و یک پیام خطا به کاربر ارائه دهید، به صورت اختیاری یک نام گروه تبلیغاتی منحصر به فرد را پیشنهاد می کند یا لیست نام های در حال استفاده را نشان می دهد. |
---|
نکات پیشگیری | N/A |
---|
|
|
---|
DUPLICATE_ASSET | خلاصه | دو عملیات در یک درخواست واحد شامل عملیات ایجاد برای یک دارایی با داده های باینری یکسان است. |
---|
علل رایج | یک درخواست جهش با عملیات ایجاد تکراری حاوی داده های باینری یکسان. |
---|
نحوه رسیدگی | دارایی را در یک درخواست جداگانه ایجاد کنید، سپس در درخواست بعدی به آن پیوند دهید. یا از یک شناسه موقت در همان درخواست استفاده کنید. |
---|
نکات پیشگیری | N/A |
---|
|
|
---|
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 مراجعه کنید. |
---|
|
|
---|
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 را به عنوان شناسه حساب مدیر بدون خط تیره ( - ) مشخص کنید. کتابخانه های مشتری برای این کار پشتیبانی کرده اند. |
---|
|
|
---|
BID_TOO_MANY_FRACTIONAL_DIGITS | خلاصه | ارزش پیشنهادی مضربی دقیق از حداقل واحد پول حساب نیست. برای مثال، 0.015 دلار آمریکا ( 15000 در میکرو) پیشنهاد معتبری نیست. |
---|
علل رایج | N/A |
---|
نحوه رسیدگی | N/A |
---|
نکات پیشگیری | بررسی کنید که پیشنهادات مضرب حداقل واحد برای ارز حساب است. |
---|
|
BID_TOO_BIG | خلاصه | حتی اگر پیشنهاد در محدوده بودجه کمپین باشد، خطا برگردانده می شود. |
---|
علل رایج | N/A |
---|
نحوه رسیدگی | N/A |
---|
نکات پیشگیری | بررسی کنید که آیا حساب در Google Ad Grants مشارکت دارد یا خیر. اگر چنین است، پیشنهادات CPC را به حداکثر تعیین شده توسط برنامه محدود کنید. |
---|
|
|
---|
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC | خلاصه | مقدار بودجه خیلی کم است. |
---|
علل رایج | N/A |
---|
نحوه رسیدگی | N/A |
---|
نکات پیشگیری | بررسی کنید که مقدار بودجه بیشتر یا برابر با حداقل واحد پول حساب باشد. |
---|
|
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT | خلاصه | وقتی از یک مقدار خرد به یک مقدار به واحد پول حساب تبدیل شود، مقدار بودجه دارای ارقام اعشاری بسیار زیادی خواهد بود. |
---|
علل رایج | N/A |
---|
نحوه رسیدگی | N/A |
---|
نکات پیشگیری | بررسی کنید که مقدار بودجه بر حداقل واحد پول حساب قابل تقسیم است. |
---|
|
|
---|
DUPLICATE_CAMPAIGN_NAME | خلاصه | یک کمپین در حال اضافه شدن یا تغییر نام است، اما نام در حال حاضر توسط یک کمپین دیگر استفاده شده است. |
---|
علل رایج | ایجاد یک کمپین جدید با نام یک کمپین فعال یا متوقف شده موجود. |
---|
نحوه رسیدگی | خطا را ثبت کنید و یک پیام خطا به کاربر ارائه دهید، که به صورت اختیاری یک نام کمپین منحصر به فرد را پیشنهاد می کند یا لیست نام های در حال استفاده را نشان می دهد. |
---|
نکات پیشگیری | N/A |
---|
|
|
---|
KEYWORD_HAS_INVALID_CHARS | خلاصه | افزودن یا ویرایش کلمات کلیدی که دارای کاراکترهای نامعتبر هستند. |
---|
علل رایج | از کاراکترهای خاص مانند ! @ % * در کلمات کلیدی. |
---|
نحوه رسیدگی | N/A |
---|
نکات پیشگیری | اطمینان حاصل کنید که از هیچ کاراکتر غیر مجاز در کلمات کلیدی استفاده نکنید. به افزودن کلمات کلیدی مراجعه کنید. |
---|
|
|
---|
DUPLICATE_ELEMENT | خلاصه | درخواست شامل دو پارامتر است که یکسان و اضافی هستند. |
---|
علل رایج | N/A |
---|
نحوه رسیدگی | N/A |
---|
نکات پیشگیری | قبل از درخواست، موارد تکراری (عملیات، پارامترها، عناصر لیست) را حذف کنید. به دنبال فیلدهایی باشید که دارای محدودیت DistinctElements هستند. |
---|
|
|
---|
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 غیرقابل استفاده می کند و هر گونه نشانه دسترسی را که از توکن تازه سازی برای تولید استفاده شده است، بی اعتبار می کند. |
---|
نکات پیشگیری | اطمینان حاصل کنید که رمز بهروزرسانی خود را در مکانی امن ذخیره میکنید تا از نیاز به بازسازی جلوگیری کنید. |
---|
|
|
---|
RESOURCE_NOT_FOUND | خلاصه | درخواست به منبعی اشاره کرد که یافت نشد. |
---|
علل رایج | این درخواست سعی در تغییر یا ارجاع به منبعی دارد که وجود ندارد یا حذف شده است. یا نام منبع داده شده برای منبع بد شکل است. |
---|
نحوه رسیدگی | قبل از ارسال درخواست جهش، از یک درخواست جستجو برای بازیابی نام منبع برای یک منبع موجود استفاده کنید. راهنماهای کتابخانه مشتری ما را مرور کنید، که شامل مستنداتی در مورد نحوه ساخت نام منابع معتبر در هر زبان پشتیبانی شده است |
---|
نکات پیشگیری | نام منابع را به صورت دستی ایجاد نکنید. از یکی از روش های کمکی ارائه شده توسط کتابخانه های مشتری ما استفاده کنید. |
---|
|
|
---|
EMPTY_LIST | خلاصه | یک لیست مورد نیاز خالی است. |
---|
علل رایج | انتقال در لیست خالی از عملیات به روش mutate . |
---|
نحوه رسیدگی | N/A |
---|
نکات پیشگیری | N/A |
---|
|
|
---|
RESOURCE_EXHAUSTED | خلاصه | از حد فرکانس سیستم فراتر رفته است. |
---|
علل رایج | N/A |
---|
نحوه رسیدگی | N/A |
---|
نکات پیشگیری | تأخیرهای کوتاهی را بین درخواست ها تنظیم کنید یا عملیات های بیشتری را در درخواست های کمتر ترکیب کنید. |
---|
|
|
---|
TOO_LOW | خلاصه | یک مقدار کمتر از حداقل مجاز بود. |
---|
علل رایج | فراموش کردن تعیین یک شناسه، که منجر به ارسال مقدار 0 می شود. |
---|
نحوه رسیدگی | N/A |
---|
نکات پیشگیری | به محدودیت های محدوده مستند شده در مرجع API توجه کنید. |
---|
|
|
---|
INVALID_INPUT | خلاصه | درخواست بد شکل است. |
---|
علل رایج | URL یا محتوای درخواست بد شکل است. |
---|
نحوه رسیدگی | N/A |
---|
نکات پیشگیری | N/A |
---|
|
REQUIRED_FIELD_MISSING | خلاصه | درخواست اطلاعات لازم را ندارد. |
---|
علل رایج | هنگام تلاش برای افزودن یک موجود، فیلدهای الزامی را از دست داده است. |
---|
نحوه رسیدگی | خطا را ثبت کنید و یک پیام خطا به کاربر ارائه دهید. ویژگی fieldPath خطا نشان می دهد که کدام فیلد وجود ندارد. |
---|
نکات پیشگیری | برای اطلاع از اینکه کدام فیلدها مورد نیاز است به مرجع API مراجعه کنید. |
---|
|
|
---|
RESOURCE_LIMIT | خلاصه | این درخواست در حال تلاش برای ایجاد منبعی است که باعث می شود تعداد کل آن منابع از حد مشخص شده فراتر رود. |
---|
علل رایج | محدودیت های متعددی در مورد تعداد منابعی که می توانند در زمینه های خاص وجود داشته باشند وجود دارد. |
---|
نحوه رسیدگی | با مرور محدودیتهای سیستم، محدودیتی را که با آن مواجه میشوید، شناسایی کنید. یا از یک منبع موجود استفاده مجدد کنید، یا منابع را حذف کنید تا فضایی برای منابع جدید ایجاد کنید. |
---|
نکات پیشگیری | از عبارت های جستجو برای نظارت بر تعداد منابعی که دارای محدودیت هستند استفاده کنید. |
---|
|
|
---|
TOO_LONG | خلاصه | رشته اختصاص داده شده به فیلد مشخص شده طولانی تر از حد است. |
---|
علل رایج | عناوین یا توضیحات تبلیغات حاوی متن بیش از حد است. |
---|
نحوه رسیدگی | محدودیتی را که با آن مواجه میشوید شناسایی کنید، رشته را مطابق با آن تغییر دهید و درخواست را دوباره ارسال کنید. |
---|
نکات پیشگیری | از محدودیت های طول رشته آگاه باشید. |
---|
|
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-12-02 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-12-02 بهوقت ساعت هماهنگ جهانی."],[[["The Google Ads API returns a variety of errors related to authentication, ads, assets, bidding, and budgets, providing specific error codes for troubleshooting."],["Common causes of errors include invalid inputs, exceeding limits, and resource conflicts, necessitating careful validation of data and adherence to API guidelines."],["Suggested solutions involve correcting inputs, adjusting values to meet requirements, ensuring unique names, and retrying with exponential backoff for transient errors."],["Understanding the error codes and their corresponding descriptions enables developers to effectively diagnose and resolve issues encountered during API interactions."],["Developers should consult the Google Ads API documentation for detailed explanations of each error and recommended best practices to avoid them."]]],[]]