خطاهای رایج

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

google.auth.exceptions.RefreshError

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

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