خطاهای رایج
این صفحه خطاهای رایج را فهرست می کند و نکاتی در مورد پیشگیری و مدیریت آنها ارائه می دهد. برای فهرست کامل خطاها، مراجع خطا را مرور کنید. برای حمایت بیشتر، از انجمن ما دیدن کنید.
google.auth.exceptions.RefreshError |
|---|
invalid_grant | | خلاصه | توکن منقضی شده یا باطل شده است. |
|---|
| علل رایج | یک پروژه Google Cloud Platform با صفحه رضایت OAuth که برای نوع کاربر خارجی پیکربندی شده است و وضعیت انتشار Testing یک نشانه به‌روزرسانی صادر می‌کند که طی 7 روز منقضی می‌شود. |
|---|
| نحوه رسیدگی | وضعیت انتشار پروژه Google شما در Testing است، بنابراین رمز به‌روزرسانی هر ۷ روز منقضی می‌شود و یک خطای invalid_grant دریافت می‌کند. به کنسول API Google بروید و به صفحه رضایت OAuth بروید. سپس وضعیت انتشار را با پیروی از این دستورالعمل‌ها به In production تغییر دهید تا از انقضای توکن به‌روزرسانی در ۷ روز جلوگیری کنید. |
|---|
| نکات پیشگیری | برنامه‌های تأیید نشده را ببینید. |
|---|
|
|
|---|
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 |
|---|
| نکات پیشگیری | مطمئن شوید که رمز دسترسی صحیح مرتبط با حساب خود را ارسال کرده اید. گاهی اوقات با توکن های تازه سازی و کدهای مجوز اشتباه گرفته می شود. اگر می‌خواهید اعتبارنامه‌ای دریافت کنید که بتواند به همه حساب‌های مشتری تحت یک حساب مدیر دسترسی داشته باشد، مطمئن شوید که رمز تازه‌سازی حساب مدیر را دریافت کرده‌اید. برای جزئیات بیشتر، به راهنمای ما در مورد نشانه دسترسی و refresh token و 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 را به عنوان شناسه حساب مدیر بدون خط تیره ( - ) مشخص کنید. کتابخانه های مشتری برای این کار پشتیبانی کرده اند. |
|---|
|
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2024-12-02 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2024-12-02 بهوقت ساعت هماهنگ جهانی."],[[["This page provides information on common Google Ads API errors, including causes and prevention strategies."],["You can find a complete list of errors in the error references section, linked on this page."],["For additional assistance and community support, visit the Google Ads API forum, also linked on this page."],["Errors can arise from invalid tokens, incorrect customer IDs, or insufficient permissions, among other causes."],["Following the prevention tips and handling instructions provided can help you resolve common API issues."]]],[]]
