خطاهای رایج

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

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

قبلی
یک تماس API برقرار کنید
بعدی
مراحل بعدی