با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
این صفحه خطاهای رایج را فهرست می کند و نکاتی در مورد پیشگیری و مدیریت آنها ارائه می دهد. برای فهرست کامل خطاها، مراجع خطا را مرور کنید. برای حمایت بیشتر، از انجمن ما دیدن کنید.
google.rpc.ErrorInfo
ACCESS_TOKEN_SCOPE_INSUFFICIENT
خلاصه
نشانه دسترسی OAuth 2.0 محدوده های لازم را ندارد.
علل رایج
این درخواست رد می شود زیرا رمز دسترسی ارائه شده شامل محدوده Google Ads API OAuth 2.0 نمی شود.
نحوه رسیدگی
مطمئن شوید که نشانه دسترسی دارای محدوده های مورد نیاز است. یک دلیل رایج برای این خطا این است که شما در حال استفاده مجدد از یک نشانه دسترسی موجود هستید که با استفاده از مجموعه دیگری از محدوده های OAuth ایجاد شده است. پارامترهای مجوز OAuth را برای مثالی از نحوه ایجاد یک نشانه دسترسی جدید با دامنه های مورد نیاز ببینید.
نکات پیشگیری
اطمینان حاصل کنید که رمز دسترسی دارای محدوده های مورد نیاز است. برای به دست آوردن دسترسی با محدوده های مورد نیاز، کاربر خود را مجدداً احراز هویت کنید. اگر برنامه شما از چندین دامنه OAuth استفاده می کند، ممکن است نیاز باشد مجوزهای Granular OAuth را پیاده سازی کنید.
google.auth.exceptions.RefreshError
invalid_grant
خلاصه
توکن منقضی شده یا باطل شده است.
علل رایج
یک پروژه Google Cloud Platform با صفحه رضایت OAuth که برای نوع کاربر خارجی پیکربندی شده است و وضعیت انتشار Testing یک نشانه به‌روزرسانی صادر می‌کند که طی 7 روز منقضی می‌شود.
نحوه رسیدگی
وضعیت انتشار پروژه Google شما در Testing است، بنابراین رمز به‌روزرسانی هر ۷ روز منقضی می‌شود و یک خطای invalid_grant دریافت می‌کند. به کنسول API Google بروید و به صفحه رضایت OAuth بروید. سپس وضعیت انتشار را با پیروی از این دستورالعمل‌ها به In production تغییر دهید تا از انقضای توکن به‌روزرسانی در ۷ روز جلوگیری کنید.
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 مراجعه کنید.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN
خلاصه
توکن توسعه‌دهنده قبلاً با یک سازمان Google Cloud مرتبط است و نمی‌تواند با سازمان دیگری مرتبط شود.
علل رایج
توکن توسعه‌دهنده با پروژه Google Cloud در همان سازمان Google Cloud که پروژه Google Cloud در ابتدا برای درخواست‌ها استفاده می‌شد، مرتبط نیست.
نحوه رسیدگی
مطمئن شوید که شناسه مشتری OAuth با پروژه‌های Google Cloud در همان سازمان Google Cloud مرتبط باشد، اگر قبلاً درخواست‌های API را با توکن توسعه‌دهنده انجام داده‌اید.
نکات پیشگیری
مطمئن شوید که همه پروژه‌های Google Cloud شما با همان سازمان Google Cloud مرتبط هستند. یک پروژه Google Cloud را می توان تنها با یک توکن توسعه دهنده مرتبط کرد، اما یک توکن توسعه دهنده را می توان با چندین پروژه در سازمان مرتبط کرد.
دسترسی به حساب مشتری امکان پذیر نیست زیرا در حالت فعال نیست.
علل رایج
این زمانی اتفاق می‌افتد که حساب مشتری ثبت‌نام را تمام نکرده یا غیرفعال شده باشد.
نحوه رسیدگی
وارد رابط کاربری Google Ads شوید و مطمئن شوید که فرآیند ثبت نام برای این حساب را تکمیل کرده اید. برای حساب‌های غیرفعال‌شده، به فعال‌سازی مجدد حساب لغو شده Google Ads مراجعه کنید.
نکات پیشگیری
با بررسی وضعیت لغو شده ، می‌توانید فعالانه بررسی کنید که آیا حساب مشتری غیرفعال شده است.
DEVELOPER_TOKEN_NOT_APPROVED
خلاصه
توکن توسعه‌دهنده فقط برای استفاده با حساب‌های آزمایشی تأیید شده است و سعی شده به یک حساب غیر آزمایشی دسترسی پیدا کند.
علل رایج
برای دسترسی به یک حساب غیر آزمایشی از یک توکن توسعه دهنده آزمایشی استفاده شد.
توکن توسعه دهنده با پروژه ارسال شده در درخواست مجاز نیست.
علل رایج
هر پروژه Google API Console را می توان با توکن توسعه دهنده تنها از یک حساب مدیر مرتبط کرد. هنگامی که یک درخواست Google Ads API ارائه می کنید، توکن توسعه دهنده به طور دائم با پروژه Google API Console جفت می شود. اگر از پروژه Google API Console جدید استفاده نکنید، هنگام درخواست با خطای DEVELOPER_TOKEN_PROHIBITED مواجه خواهید شد.
احراز هویت به عنوان یک کاربر با دسترسی به حساب مدیر، اما عدم تعیین login-customer-id در درخواست.
نحوه رسیدگی
N/A
نکات پیشگیری
شناسه login-customer-id به عنوان شناسه حساب مدیر بدون خط تیره ( - ) مشخص کنید. کتابخانه های مشتری برای این کار پشتیبانی کرده اند.
،
این صفحه خطاهای رایج را فهرست می کند و نکاتی در مورد پیشگیری و مدیریت آنها ارائه می دهد. برای فهرست کامل خطاها، مراجع خطا را مرور کنید. برای حمایت بیشتر، از انجمن ما دیدن کنید.
google.rpc.ErrorInfo
ACCESS_TOKEN_SCOPE_INSUFFICIENT
خلاصه
نشانه دسترسی OAuth 2.0 محدوده های لازم را ندارد.
علل رایج
این درخواست رد می شود زیرا رمز دسترسی ارائه شده شامل محدوده Google Ads API OAuth 2.0 نمی شود.
نحوه رسیدگی
مطمئن شوید که نشانه دسترسی دارای محدوده های مورد نیاز است. یک دلیل رایج برای این خطا این است که شما در حال استفاده مجدد از یک نشانه دسترسی موجود هستید که با استفاده از مجموعه دیگری از محدوده های OAuth ایجاد شده است. پارامترهای مجوز OAuth را برای مثالی از نحوه ایجاد یک نشانه دسترسی جدید با دامنه های مورد نیاز ببینید.
نکات پیشگیری
اطمینان حاصل کنید که رمز دسترسی دارای محدوده های مورد نیاز است. برای به دست آوردن دسترسی با محدوده های مورد نیاز، کاربر خود را مجدداً احراز هویت کنید. اگر برنامه شما از چندین دامنه OAuth استفاده می کند، ممکن است نیاز باشد مجوزهای Granular OAuth را پیاده سازی کنید.
google.auth.exceptions.RefreshError
invalid_grant
خلاصه
توکن منقضی شده یا باطل شده است.
علل رایج
یک پروژه Google Cloud Platform با صفحه رضایت OAuth که برای نوع کاربر خارجی پیکربندی شده است و وضعیت انتشار Testing یک نشانه به‌روزرسانی صادر می‌کند که طی 7 روز منقضی می‌شود.
نحوه رسیدگی
وضعیت انتشار پروژه Google شما در Testing است، بنابراین رمز به‌روزرسانی هر ۷ روز منقضی می‌شود و یک خطای invalid_grant دریافت می‌کند. به کنسول API Google بروید و به صفحه رضایت OAuth بروید. سپس وضعیت انتشار را با پیروی از این دستورالعمل‌ها به In production تغییر دهید تا از انقضای توکن به‌روزرسانی در ۷ روز جلوگیری کنید.
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 مراجعه کنید.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN
خلاصه
توکن توسعه‌دهنده قبلاً با یک سازمان Google Cloud مرتبط است و نمی‌تواند با سازمان دیگری مرتبط شود.
علل رایج
توکن توسعه‌دهنده با پروژه Google Cloud در همان سازمان Google Cloud که پروژه Google Cloud در ابتدا برای درخواست‌ها استفاده می‌شد، مرتبط نیست.
نحوه رسیدگی
مطمئن شوید که شناسه مشتری OAuth با پروژه‌های Google Cloud در همان سازمان Google Cloud مرتبط باشد، اگر قبلاً درخواست‌های API را با توکن توسعه‌دهنده انجام داده‌اید.
نکات پیشگیری
مطمئن شوید که همه پروژه‌های Google Cloud شما با همان سازمان Google Cloud مرتبط هستند. یک پروژه Google Cloud را می توان تنها با یک توکن توسعه دهنده مرتبط کرد، اما یک توکن توسعه دهنده را می توان با چندین پروژه در سازمان مرتبط کرد.
دسترسی به حساب مشتری امکان پذیر نیست زیرا در حالت فعال نیست.
علل رایج
این زمانی اتفاق می‌افتد که حساب مشتری ثبت‌نام را تمام نکرده یا غیرفعال شده باشد.
نحوه رسیدگی
وارد رابط کاربری Google Ads شوید و مطمئن شوید که فرآیند ثبت نام برای این حساب را تکمیل کرده اید. برای حساب‌های غیرفعال‌شده، به فعال‌سازی مجدد حساب لغو شده Google Ads مراجعه کنید.
نکات پیشگیری
با بررسی وضعیت لغو شده ، می‌توانید فعالانه بررسی کنید که آیا حساب مشتری غیرفعال شده است.
DEVELOPER_TOKEN_NOT_APPROVED
خلاصه
توکن توسعه‌دهنده فقط برای استفاده با حساب‌های آزمایشی تأیید شده است و سعی شده به یک حساب غیر آزمایشی دسترسی پیدا کند.
علل رایج
برای دسترسی به یک حساب غیر آزمایشی از یک توکن توسعه دهنده آزمایشی استفاده شد.
توکن توسعه دهنده با پروژه ارسال شده در درخواست مجاز نیست.
علل رایج
هر پروژه Google API Console را می توان با توکن توسعه دهنده تنها از یک حساب مدیر مرتبط کرد. هنگامی که یک درخواست Google Ads API ارائه می کنید، توکن توسعه دهنده به طور دائم با پروژه Google API Console جفت می شود. اگر از پروژه Google API Console جدید استفاده نکنید، هنگام درخواست با خطای DEVELOPER_TOKEN_PROHIBITED مواجه خواهید شد.
تاریخ آخرین به‌روزرسانی 2025-06-04 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین به‌روزرسانی 2025-06-04 بهوقت ساعت هماهنگ جهانی."],[[["This page provides solutions and preventative measures for common Google Ads API errors."],["For a comprehensive list of errors, refer to the dedicated error references section."],["Additional assistance and community support can be found on the Google Ads API forum."],["Understanding and addressing these errors is crucial for successful API integration and campaign management."]]],[]]