در تاریخ 16 اکتبر به صورت زنده در Discord در سرور انجمن تبلیغات و اندازه گیری Google به ما بپیوندید! در مورد ویژگی های جدید اضافه شده در V22 Google Ads API صحبت خواهیم کرد.
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
این صفحه خطاهای رایج را فهرست کرده و نکاتی در مورد پیشگیری و مدیریت آنها ارائه میدهد. برای مشاهده لیست کامل خطاها، منابع خطا را بررسی کنید. برای پشتیبانی بیشتر، از انجمن ما دیدن کنید.
google.rpc.ErrorInfo
ACCESS_TOKEN_SCOPE_INSUFFICIENT
خلاصه
توکن دسترسی OAuth 2.0 دامنههای مورد نیاز را ندارد.
علل شایع
درخواست رد میشود زیرا توکن دسترسی ارائه شده شامل محدودهی OAuth 2.0 مربوط به API تبلیغات گوگل نمیشود.
نحوه رسیدگی
مطمئن شوید که توکن دسترسی، محدودههای مورد نیاز را دارد. یکی از دلایل رایج این خطا این است که شما در حال استفاده مجدد از یک توکن دسترسی موجود هستید که با استفاده از مجموعهای متفاوت از محدودههای OAuth تولید شده است. برای مثالی از نحوه تولید یک توکن دسترسی جدید با محدودههای مورد نیاز، به پارامترهای مجوز OAuth مراجعه کنید.
نکات پیشگیری
مطمئن شوید که توکن دسترسی، محدودههای مورد نیاز را دارد. برای دسترسی به محدودههای مورد نیاز، کاربر خود را با محدودههای مورد نیاز مجدداً احراز هویت کنید. اگر برنامه شما از چندین محدوده OAuth استفاده میکند، ممکن است نیاز به پیادهسازی مجوزهای Granular OAuth داشته باشید.
google.auth.exceptions.RefreshError
invalid_grant
خلاصه
توکن منقضی یا باطل شده است.
علل شایع
به یک پروژه پلتفرم ابری گوگل که صفحه رضایت OAuth آن برای نوع کاربر خارجی پیکربندی شده و وضعیت انتشار آن در Testing است، یک توکن بهروزرسانی صادر میشود که ظرف ۷ روز منقضی میشود.
نحوه رسیدگی
وضعیت انتشار پروژه گوگل شما در Testing است، بنابراین توکن بهروزرسانی هر ۷ روز یکبار منقضی میشود و خطای invalid_grant دریافت میکند. به کنسول API گوگل بروید و به صفحه رضایت OAuth بروید. سپس با دنبال کردن این دستورالعملها، وضعیت انتشار را به In production تغییر دهید تا از منقضی شدن توکن بهروزرسانی ظرف ۷ روز جلوگیری شود.
پس از ایجاد یک تبلیغ، دیگر نمیتوان آن را تغییر داد. اگر میخواهید تبلیغ را تغییر دهید، باید یک تبلیغ جدید ایجاد کنید و سپس تبلیغ قدیمی را حذف کنید. با این حال، status تبلیغ با استفاده از MutateAdGroupAds قابل تغییر است.
INVALID_INPUT
خلاصه
یکی از فیلدهای یک تبلیغ حاوی نویسههای نامعتبر است.
علل شایع
استفاده از کاراکترهای ویژه در URLها
نحوه رسیدگی
ناموجود
نکات پیشگیری
قبل از ارسال درخواست API، URL ها را در برنامه خود اعتبارسنجی کنید.
یک گروه تبلیغاتی اضافه یا تغییر نام داده میشود، اما این نام قبلاً توسط یک گروه تبلیغاتی دیگر استفاده میشود.
علل شایع
ایجاد یک گروه تبلیغاتی جدید با نام یک گروه تبلیغاتی فعال یا متوقف شده موجود.
نحوه رسیدگی
خطا را ثبت کنید و یک پیام خطا به کاربر نشان دهید، که به صورت اختیاری میتواند یک نام منحصر به فرد برای گروه تبلیغاتی پیشنهاد دهد یا لیست نامهای مورد استفاده را نشان دهد.
۱۲۳-۴۵۶-۷۸۹۰ باید ۱۲۳۴۵۶۷۸۹۰ باشد. برای جزئیات بیشتر به «شروع به کار» مراجعه کنید.
CLIENT_CUSTOMER_ID_IS_REQUIRED
خلاصه
شناسه مشتری کلاینت در هدر HTTP مشخص نشده است.
علل شایع
عدم مشخص کردن شناسه مشتری کلاینت در هدر HTTP.
نحوه رسیدگی
ناموجود
نکات پیشگیری
شناسه مشتری کلاینت برای همه فراخوانیها لازم است، بنابراین مطمئن شوید که آن را در هدر HTTP مشخص کردهاید. استفاده از کتابخانههای کلاینت ما را در نظر بگیرید زیرا آنها این کار را برای شما انجام میدهند.
CUSTOMER_NOT_FOUND
خلاصه
هیچ حسابی برای شناسه مشتری ارائه شده در سربرگ یافت نشد.
علل شایع
تلاش برای دسترسی به حسابی که قبل از ایجاد حساب در backend ایجاد شده است.
نحوه رسیدگی
پنج دقیقه اول صبر کنید، سپس هر 30 ثانیه دوباره امتحان کنید.
نکات پیشگیری
قبل از ارسال درخواست علیه حساب، چند دقیقه پس از ایجاد حساب صبر کنید.
GOOGLE_ACCOUNT_COOKIE_INVALID
خلاصه
توکن دسترسی موجود در هدر درخواست یا نامعتبر است یا منقضی شده است.
علل شایع
توکن دسترسی نامعتبر شده است.
نحوه رسیدگی
درخواست یک توکن جدید. اگر از یکی از کتابخانههای کلاینت ما استفاده میکنید، برای نحوه بهروزرسانی توکن، به مستندات آن مراجعه کنید.
نکات پیشگیری
توکنهای دسترسی را تا زمان انقضا ذخیره و دوباره استفاده کنید.
NOT_ADS_USER
خلاصه
حساب گوگلی که برای تولید توکن دسترسی استفاده میشود، به هیچ حساب گوگل ادز مرتبط نیست.
علل شایع
اطلاعات ورود ارائه شده مربوط به یک حساب گوگل است که تبلیغات گوگل در آن فعال نیست.
نحوه رسیدگی
مطمئن شوید که برای جریان OAuth با یک حساب کاربری معتبر گوگل ادز (معمولاً حساب کاربری مدیر شما) وارد سیستم میشوید. همچنین میتوانید با ورود به حساب کاربری مدیر خود، انتخاب حساب کاربری مشتری یا مدیر مورد نظر، رفتن به Tools and Settings > Access and security و سپس اضافه کردن آدرس ایمیل حساب کاربری گوگل، حساب کاربری گوگل را برای دسترسی به یک حساب کاربری گوگل ادز موجود دعوت کنید.
نکات پیشگیری
ناموجود
OAUTH_TOKEN_INVALID
خلاصه
توکن دسترسی OAuth در هدر معتبر نیست.
علل شایع
توکن دسترسی شما که با هدر HTTP ارسال شده بود، صحیح نبود.
نحوه رسیدگی
ناموجود
نکات پیشگیری
مطمئن شوید که توکن دسترسی صحیح مرتبط با حساب کاربری خود را وارد کردهاید. گاهی اوقات با توکنهای تازهسازی و کدهای مجوز اشتباه گرفته میشود. اگر میخواهید اعتبارنامهای دریافت کنید که بتواند به همه حسابهای کاربری تحت یک حساب کاربری مدیر دسترسی داشته باشد، مطمئن شوید که توکن تازهسازی را برای حساب کاربری مدیر دریافت کردهاید. به راهنمای احراز هویت کاربر مراجعه کنید.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN
خلاصه
توکن توسعهدهنده از قبل با یک سازمان Google Cloud مرتبط است و نمیتواند با سازمان دیگری مرتبط شود.
علل شایع
توکن توسعهدهنده با یک پروژه Google Cloud در همان سازمان Google Cloud که پروژه Google Cloud در ابتدا برای ارسال درخواستها استفاده میکرد، مرتبط نیست.
نحوه رسیدگی
اگر قبلاً درخواستهای API را با توکن توسعهدهنده ارسال کردهاید، مطمئن شوید که شناسه کلاینت OAuth با پروژههای Google Cloud در همان سازمان Google Cloud مرتبط باشد.
نکات پیشگیری
مطمئن شوید که تمام پروژههای گوگل کلود شما با یک سازمان گوگل کلود مرتبط هستند. یک پروژه گوگل کلود میتواند فقط با یک توکن توسعهدهنده مرتبط باشد، اما یک توکن توسعهدهنده میتواند با چندین پروژه در آن سازمان مرتبط باشد.
DEVELOPER_TOKEN_INVALID
خلاصه
توکن توسعهدهنده نامعتبر است.
علل شایع
دلایل رایج این خطا شامل غلط املایی در توکن توسعهدهنده یا تنظیم نادرست توکن توسعهدهنده در یک هدر درخواست متفاوت است.
نحوه رسیدگی
مطمئن شوید که توکن توسعهدهنده را از مرکز API کپی میکنید تا از اشتباهات تایپی جلوگیری شود. میتوانید مرکز API را در حساب مدیریت تبلیغات گوگل خود پیدا کنید . همچنین، مطمئن شوید که توکن توسعهدهنده را در هدر صحیح تنظیم میکنید. توکنهای توسعهدهنده گاهی اوقات با توکنهای بهروزرسانی OAuth و کدهای مجوز اشتباه گرفته میشوند. اطلاعات بیشتر در مورد هدرهای درخواست مختلف را اینجا بخوانید.
دسترسی به حساب مشتری امکانپذیر نیست زیرا در حالت فعال نیست.
علل شایع
این اتفاق زمانی رخ میدهد که حساب مشتری ثبت نام را تکمیل نکرده یا غیرفعال شده باشد.
نحوه رسیدگی
وارد رابط کاربری گوگل ادز شوید و مطمئن شوید که مراحل ثبت نام برای این حساب را تکمیل کردهاید. برای حسابهای غیرفعال شده، به بخش فعالسازی مجدد حساب لغو شده گوگل ادز مراجعه کنید.
نکات پیشگیری
شما میتوانید با بررسی وضعیت «لغو شده» ، غیرفعال شدن حساب مشتری را بررسی کنید.
DEVELOPER_TOKEN_NOT_APPROVED
خلاصه
توکن توسعهدهنده فقط برای استفاده با حسابهای آزمایشی و تلاش برای دسترسی به یک حساب غیر آزمایشی تأیید شده است.
علل شایع
یک توکن توسعهدهنده آزمایشی برای دسترسی به یک حساب کاربری غیر آزمایشی استفاده شده است.
استفاده از توکن توسعهدهنده در پروژه ارسالی در درخواست مجاز نیست.
علل شایع
هر پروژه کنسول API گوگل میتواند فقط از یک حساب کاربری مدیر به توکن توسعهدهنده مرتبط شود. پس از ارسال درخواست API گوگل ادز، توکن توسعهدهنده به طور دائم به پروژه کنسول API گوگل متصل میشود. اگر از یک پروژه جدید کنسول API گوگل استفاده نکنید، هنگام ارسال درخواست با خطای DEVELOPER_TOKEN_PROHIBITED مواجه خواهید شد.
یک کمپین در حال اضافه شدن یا تغییر نام است، اما این نام در حال حاضر توسط یک کمپین دیگر استفاده میشود.
علل شایع
ایجاد یک کمپین جدید با نام یک کمپین فعال یا متوقف شده موجود.
نحوه رسیدگی
خطا را ثبت کنید و یک پیام خطا به کاربر نشان دهید، که به صورت اختیاری میتواند یک نام کمپین منحصر به فرد پیشنهاد دهد یا لیست نامهای مورد استفاده را نشان دهد.
مهلت درخواست تمام شده و نمیتواند به سرعت کافی برای بازگرداندن پاسخ تکمیل شود.
علل شایع
یک درخواست جستجو ایجاد شده که پاسخ بسیار بزرگی ایجاد کرده است، یا یک درخواست تغییر شکل برای پردازش بسیار بزرگ بوده است.
نحوه رسیدگی
حدود 30 ثانیه صبر کنید، سپس درخواست را دوباره امتحان کنید. اگر خطا ادامه داشت، سعی کنید درخواست را به چندین درخواست کوچکتر تقسیم کنید که بتوانند سریعتر تکمیل شوند.
هر درخواستی که با این خطا با شکست مواجه شده است را با استفاده از یک برنامهی بازگشت نمایی برای تلاشهای مجدد، دوباره امتحان کنید.
نکات پیشگیری
ناموجود
TRANSIENT_ERROR
خلاصه
یک خطای داخلی گذرا رخ داده است و باید دوباره امتحان شود.
علل شایع
این خطا زمانی رخ میدهد که API به صورت داخلی با یک مشکل موقت مواجه شود.
نحوه رسیدگی
هر درخواستی که با این خطا با شکست مواجه شده است را با استفاده از یک برنامهی بازگشت نمایی برای تلاشهای مجدد، دوباره امتحان کنید.
نکات پیشگیری
ناموجود
InvalidGrantError
invalid_grant (malformed auth code)
خلاصه
کد مجوزی که با توکنهای OAuth مبادله شده بود، ناقص بود.
علل شایع
این اتفاق هنگام تلاش برای تولید یک توکن بهروزرسانی برای کاربری که قبلاً به برنامه درخواستکننده دسترسی داده شده است، رخ میدهد. برای مثال، این اتفاق میتواند هنگام اجرای بیش از یک بار مثال «ایجاد اعتبارنامههای کاربر» برای همان اعتبارنامههای کلاینت OAuth و تأیید اعتبار کاربر رخ دهد.
نحوه رسیدگی
برای تولید مجدد یک توکن بهروزرسانی برای ترکیبی از اعتبارنامههای کاربر مجاز و کلاینت OAuth، توکن بهروزرسانی موجود را لغو کنید . توجه داشته باشید که لغو یک توکن، آن را برای دسترسی به API تبلیغات گوگل غیرقابل استفاده میکند و هرگونه توکن دسترسی که توکن بهروزرسانی برای تولید آن استفاده شده است را باطل میکند.
نکات پیشگیری
حتماً توکن بهروزرسانی خود را در مکانی امن ذخیره کنید تا از نیاز به بازسازی آن جلوگیری شود.
درخواست سعی در تغییر یا ارجاع به منبعی دارد که وجود ندارد یا حذف شده است. یا، نام منبع داده شده برای منبع نادرست است.
نحوه رسیدگی
قبل از ارسال درخواست تغییر، از یک درخواست جستجو برای بازیابی نام منبع برای یک منبع موجود استفاده کنید. راهنماهای کتابخانه مشتری ما را که شامل مستنداتی در مورد نحوه ساخت نامهای منبع معتبر در هر زبان پشتیبانی شده است، بررسی کنید.
نکات پیشگیری
نام منابع را به صورت دستی ایجاد نکنید. از یکی از روشهای کمکی ارائه شده توسط کتابخانههای کلاینت ما استفاده کنید.
این درخواست در تلاش است منبعی ایجاد کند که باعث شود تعداد کل آن منابع از حد مشخصی فراتر رود.
علل شایع
محدودیتهای متعددی در تعداد منابعی که میتوانند در زمینههای خاص وجود داشته باشند، وجود دارد.
نحوه رسیدگی
با بررسی محدودیتهای سیستم، محدودیتی را که با آن مواجه هستید شناسایی کنید. یا از یک منبع موجود دوباره استفاده کنید، یا منابع را حذف کنید تا فضای بیشتری برای منابع جدید ایجاد شود.
نکات پیشگیری
از کوئریهای جستجو برای نظارت بر تعداد منابعی که محدودیت دارند استفاده کنید.
تاریخ آخرین بهروزرسانی 2025-10-15 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-10-15 بهوقت ساعت هماهنگ جهانی."],[],[]]