در تاریخ 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 تغییر دهید تا از منقضی شدن توکن بهروزرسانی ظرف ۷ روز جلوگیری شود. |
---|
نکات پیشگیری | برنامههای تأیید نشده را ببینید. |
---|
|
|
---|
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR | خلاصه | این عملگر را نمیتوان با زیرکلاس Ad استفاده کرد. |
---|
علل شایع | تلاش برای تغییر ویژگیهایی غیر از status تبلیغ. |
---|
نحوه رسیدگی | ناموجود |
---|
نکات پیشگیری | پس از ایجاد یک تبلیغ، دیگر نمیتوان آن را تغییر داد. اگر میخواهید تبلیغ را تغییر دهید، باید یک تبلیغ جدید ایجاد کنید و سپس تبلیغ قدیمی را حذف کنید. با این حال، status تبلیغ با استفاده از MutateAdGroupAds قابل تغییر است. |
---|
|
INVALID_INPUT | خلاصه | یکی از فیلدهای یک تبلیغ حاوی نویسههای نامعتبر است. |
---|
علل شایع | استفاده از کاراکترهای ویژه در URLها |
---|
نحوه رسیدگی | ناموجود |
---|
نکات پیشگیری | قبل از ارسال درخواست API، URL ها را در برنامه خود اعتبارسنجی کنید. |
---|
|
LINE_TOO_WIDE | خلاصه | یکی از فیلدهای یک آگهی طولانیتر از حداکثر طول مجاز بود. به بخش «درباره تبلیغات متنی» مراجعه کنید. |
---|
علل شایع | داشتن یک خط متن خیلی طولانی. |
---|
نحوه رسیدگی | ناموجود |
---|
نکات پیشگیری | قبل از ارسال درخواست API، طول خط را اعتبارسنجی کنید. |
---|
|
|
---|
AD_GROUP_AD_LABEL_ALREADY_EXISTS | خلاصه | این برچسب از قبل با برخی از تبلیغات مرتبط است. |
---|
علل شایع | تلاش برای مرتبط کردن برچسب با تبلیغاتی که قبلاً مرتبط شدهاند. |
---|
نحوه رسیدگی | ناموجود |
---|
نکات پیشگیری | ابتدا بررسی کنید که آیا برچسبی که قرار است اضافه شود از قبل با تبلیغات مرتبط است یا خیر. |
---|
|
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD | خلاصه | در عملیاتی سعی شد یک آگهی حذف شده بهروزرسانی شود. |
---|
علل شایع | وقتی یک آگهی حذف میشود، دیگر نمیتوان آن را بهروزرسانی کرد—از جمله تغییر در وضعیت آن. |
---|
نحوه رسیدگی | ناموجود |
---|
نکات پیشگیری | مطمئن شوید که کد شما سعی در بهروزرسانی تبلیغات حذفشده ندارد. |
---|
|
|
---|
INVALID_KEYWORD_TEXT | خلاصه | متن کلمه کلیدی حاوی نویسههای نامعتبر است. به افزودن کلمات کلیدی مراجعه کنید. |
---|
علل شایع | متن کلمه کلیدی شامل کاراکترهای نامعتبر است. |
---|
نحوه رسیدگی | ناموجود |
---|
نکات پیشگیری | قبل از ارسال درخواست به API، متن کلمه کلیدی را در برنامه خود اعتبارسنجی کنید. |
---|
|
|
---|
DUPLICATE_ADGROUP_NAME | خلاصه | یک گروه تبلیغاتی اضافه یا تغییر نام داده میشود، اما این نام قبلاً توسط یک گروه تبلیغاتی دیگر استفاده میشود. |
---|
علل شایع | ایجاد یک گروه تبلیغاتی جدید با نام یک گروه تبلیغاتی فعال یا متوقف شده موجود. |
---|
نحوه رسیدگی | خطا را ثبت کنید و یک پیام خطا به کاربر نشان دهید، که به صورت اختیاری میتواند یک نام منحصر به فرد برای گروه تبلیغاتی پیشنهاد دهد یا لیست نامهای مورد استفاده را نشان دهد. |
---|
نکات پیشگیری | ناموجود |
---|
|
|
---|
DUPLICATE_ASSET | خلاصه | دو عملیات در یک درخواست واحد شامل یک عملیات ایجاد برای یک دارایی با دادههای دودویی یکسان است. |
---|
علل شایع | یک درخواست تغییر با عملیات ایجاد تکراری حاوی دادههای دودویی یکسان. |
---|
نحوه رسیدگی | دارایی را در یک درخواست جداگانه ایجاد کنید، سپس در درخواست بعدی به آن پیوند دهید؛ یا از یک شناسه موقت در همان درخواست استفاده کنید. |
---|
نکات پیشگیری | ناموجود |
---|
|
|
---|
CLIENT_CUSTOMER_ID_INVALID | خلاصه | شناسه مشتری کلاینت یک عدد نیست. |
---|
علل شایع | استفاده از شناسه مشتری نامناسب. |
---|
نحوه رسیدگی | ناموجود |
---|
نکات پیشگیری | ۱۲۳-۴۵۶-۷۸۹۰ باید ۱۲۳۴۵۶۷۸۹۰ باشد. برای جزئیات بیشتر به «شروع به کار» مراجعه کنید. |
---|
|
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 و کدهای مجوز اشتباه گرفته میشوند. اطلاعات بیشتر در مورد هدرهای درخواست مختلف را اینجا بخوانید. |
---|
نکات پیشگیری | ناموجود |
---|
|
|
---|
CUSTOMER_NOT_ENABLED | خلاصه | دسترسی به حساب مشتری امکانپذیر نیست زیرا در حالت فعال نیست. |
---|
علل شایع | این اتفاق زمانی رخ میدهد که حساب مشتری ثبت نام را تکمیل نکرده یا غیرفعال شده باشد. |
---|
نحوه رسیدگی | وارد رابط کاربری گوگل ادز شوید و مطمئن شوید که مراحل ثبت نام برای این حساب را تکمیل کردهاید. برای حسابهای غیرفعال شده، به بخش فعالسازی مجدد حساب لغو شده گوگل ادز مراجعه کنید. |
---|
نکات پیشگیری | شما میتوانید با بررسی وضعیت «لغو شده» ، غیرفعال شدن حساب مشتری را بررسی کنید. |
---|
|
DEVELOPER_TOKEN_NOT_APPROVED | خلاصه | توکن توسعهدهنده فقط برای استفاده با حسابهای آزمایشی و تلاش برای دسترسی به یک حساب غیر آزمایشی تأیید شده است. |
---|
علل شایع | یک توکن توسعهدهنده آزمایشی برای دسترسی به یک حساب کاربری غیر آزمایشی استفاده شده است. |
---|
نحوه رسیدگی | مطمئن شوید که واقعاً میخواهید به یک حساب کاربری غیر آزمایشی دسترسی داشته باشید. در این صورت، باید برای ارتقاء توکن توسعهدهنده خود به دسترسی استاندارد یا پایه درخواست دهید . |
---|
نکات پیشگیری | ناموجود |
---|
|
DEVELOPER_TOKEN_PROHIBITED | خلاصه | استفاده از توکن توسعهدهنده در پروژه ارسالی در درخواست مجاز نیست. |
---|
علل شایع | هر پروژه کنسول API گوگل میتواند فقط از یک حساب کاربری مدیر به توکن توسعهدهنده مرتبط شود. پس از ارسال درخواست API گوگل ادز، توکن توسعهدهنده به طور دائم به پروژه کنسول API گوگل متصل میشود. اگر از یک پروژه جدید کنسول API گوگل استفاده نکنید، هنگام ارسال درخواست با خطای DEVELOPER_TOKEN_PROHIBITED مواجه خواهید شد. |
---|
نحوه رسیدگی | ناموجود |
---|
نکات پیشگیری | اگر میخواهید با یک حساب کاربری مدیر جدید به یک توکن توسعهدهنده تغییر دهید، باید یک پروژه جدید کنسول API گوگل برای درخواستهای API تبلیغات گوگل که از توکن مدیر جدید استفاده میکنند، ایجاد کنید . |
---|
|
USER_PERMISSION_DENIED | خلاصه | مشتری مجاز به مشتری در حال کار دسترسی ندارد. |
---|
علل شایع | احراز هویت به عنوان یک کاربر با دسترسی به حساب کاربری مدیریت، اما عدم مشخص کردن login-customer-id در درخواست. |
---|
نحوه رسیدگی | ناموجود |
---|
نکات پیشگیری | login-customer-id به عنوان شناسه حساب مدیر بدون خط تیره ( - ) مشخص کنید. کتابخانههای کلاینت از این قابلیت پشتیبانی میکنند. |
---|
|
|
---|
BID_TOO_MANY_FRACTIONAL_DIGITS | خلاصه | مقدار پیشنهاد، مضرب دقیقی از حداقل واحد پول حساب نیست. برای مثال، 0.015 دلار آمریکا ( 15000 در واحد میکرو) یک پیشنهاد معتبر نیست. |
---|
علل شایع | ناموجود |
---|
نحوه رسیدگی | ناموجود |
---|
نکات پیشگیری | بررسی کنید که پیشنهادها مضربی از حداقل واحد پول حساب باشند. |
---|
|
BID_TOO_BIG | خلاصه | با اینکه مبلغ پیشنهادی در محدوده بودجه کمپین است، خطا بازگردانده میشود. |
---|
علل شایع | ناموجود |
---|
نحوه رسیدگی | ناموجود |
---|
نکات پیشگیری | بررسی کنید که آیا حساب کاربری در Google Ad Grants شرکت میکند یا خیر. در این صورت، پیشنهادهای CPC را به حداکثر میزان تعیینشده توسط برنامه محدود کنید. |
---|
|
|
---|
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC | خلاصه | مبلغ بودجه خیلی کمه. |
---|
علل شایع | ناموجود |
---|
نحوه رسیدگی | ناموجود |
---|
نکات پیشگیری | تأیید کنید که مبلغ بودجه بزرگتر یا مساوی حداقل واحد پول حساب باشد. |
---|
|
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT | خلاصه | مبلغ بودجه هنگام تبدیل از یک مبلغ خرد به مبلغی به واحد پول حساب، ارقام اعشاری بسیار زیادی خواهد داشت. |
---|
علل شایع | ناموجود |
---|
نحوه رسیدگی | ناموجود |
---|
نکات پیشگیری | تأیید کنید که مبلغ بودجه بر حداقل واحد پول حساب قابل تقسیم باشد. |
---|
|
|
---|
DUPLICATE_CAMPAIGN_NAME | خلاصه | یک کمپین در حال اضافه شدن یا تغییر نام است، اما این نام در حال حاضر توسط یک کمپین دیگر استفاده میشود. |
---|
علل شایع | ایجاد یک کمپین جدید با نام یک کمپین فعال یا متوقف شده موجود. |
---|
نحوه رسیدگی | خطا را ثبت کنید و یک پیام خطا به کاربر نشان دهید، که به صورت اختیاری میتواند یک نام کمپین منحصر به فرد پیشنهاد دهد یا لیست نامهای مورد استفاده را نشان دهد. |
---|
نکات پیشگیری | ناموجود |
---|
|
|
---|
KEYWORD_HAS_INVALID_CHARS | خلاصه | افزودن یا ویرایش کلمات کلیدی حاوی کاراکترهای نامعتبر. |
---|
علل شایع | از کاراکترهای ویژه مانند ! @ % * در کلمات کلیدی استفاده کنید. |
---|
نحوه رسیدگی | ناموجود |
---|
نکات پیشگیری | مطمئن شوید که از هیچ کاراکتر غیرمجازی در کلمات کلیدی استفاده نمیکنید. به بخش افزودن کلمات کلیدی مراجعه کنید. |
---|
|
|
---|
DUPLICATE_ELEMENT | خلاصه | این درخواست شامل دو پارامتر یکسان و تکراری است. |
---|
علل شایع | ناموجود |
---|
نحوه رسیدگی | ناموجود |
---|
نکات پیشگیری | قبل از ارسال درخواست، موارد تکراری (اعمال، پارامترها، عناصر لیست) را حذف کنید. به دنبال فیلدهایی باشید که محدودیت DistinctElements دارند. |
---|
|
|
---|
DEADLINE_EXCEEDED | خلاصه | مهلت درخواست تمام شده و نمیتواند به سرعت کافی برای بازگرداندن پاسخ تکمیل شود. |
---|
علل شایع | یک درخواست جستجو ایجاد شده که پاسخ بسیار بزرگی ایجاد کرده است، یا یک درخواست تغییر شکل برای پردازش بسیار بزرگ بوده است. |
---|
نحوه رسیدگی | حدود 30 ثانیه صبر کنید، سپس درخواست را دوباره امتحان کنید. اگر خطا ادامه داشت، سعی کنید درخواست را به چندین درخواست کوچکتر تقسیم کنید که بتوانند سریعتر تکمیل شوند. |
---|
نکات پیشگیری | برای درک چگونگی تأثیر Segmentation بر اندازه پاسخ، آن را مرور کنید. از محدودیتهای لایه انتقال gRPC آگاه باشید. |
---|
|
INTERNAL_ERROR | خلاصه | هنگام پردازش درخواست، اتفاق غیرمنتظرهای رخ داد. |
---|
علل شایع | به دلیل وجود یک اشکال، API به درستی کار نمیکند. |
---|
نحوه رسیدگی | هر درخواستی که با این خطا با شکست مواجه شده است را با استفاده از یک برنامهی بازگشت نمایی برای تلاشهای مجدد، دوباره امتحان کنید. |
---|
نکات پیشگیری | ناموجود |
---|
|
TRANSIENT_ERROR | خلاصه | یک خطای داخلی گذرا رخ داده است و باید دوباره امتحان شود. |
---|
علل شایع | این خطا زمانی رخ میدهد که API به صورت داخلی با یک مشکل موقت مواجه شود. |
---|
نحوه رسیدگی | هر درخواستی که با این خطا با شکست مواجه شده است را با استفاده از یک برنامهی بازگشت نمایی برای تلاشهای مجدد، دوباره امتحان کنید. |
---|
نکات پیشگیری | ناموجود |
---|
|
InvalidGrantError |
---|
invalid_grant (malformed auth code) | خلاصه | کد مجوزی که با توکنهای OAuth مبادله شده بود، ناقص بود. |
---|
علل شایع | این اتفاق هنگام تلاش برای تولید یک توکن بهروزرسانی برای کاربری که قبلاً به برنامه درخواستکننده دسترسی داده شده است، رخ میدهد. برای مثال، این اتفاق میتواند هنگام اجرای بیش از یک بار مثال «ایجاد اعتبارنامههای کاربر» برای همان اعتبارنامههای کلاینت OAuth و تأیید اعتبار کاربر رخ دهد. |
---|
نحوه رسیدگی | برای تولید مجدد یک توکن بهروزرسانی برای ترکیبی از اعتبارنامههای کاربر مجاز و کلاینت OAuth، توکن بهروزرسانی موجود را لغو کنید . توجه داشته باشید که لغو یک توکن، آن را برای دسترسی به API تبلیغات گوگل غیرقابل استفاده میکند و هرگونه توکن دسترسی که توکن بهروزرسانی برای تولید آن استفاده شده است را باطل میکند. |
---|
نکات پیشگیری | حتماً توکن بهروزرسانی خود را در مکانی امن ذخیره کنید تا از نیاز به بازسازی آن جلوگیری شود. |
---|
|
|
---|
RESOURCE_NOT_FOUND | خلاصه | درخواست به منبعی اشاره داشت که یافت نشد. |
---|
علل شایع | درخواست سعی در تغییر یا ارجاع به منبعی دارد که وجود ندارد یا حذف شده است. یا، نام منبع داده شده برای منبع نادرست است. |
---|
نحوه رسیدگی | قبل از ارسال درخواست تغییر، از یک درخواست جستجو برای بازیابی نام منبع برای یک منبع موجود استفاده کنید. راهنماهای کتابخانه مشتری ما را که شامل مستنداتی در مورد نحوه ساخت نامهای منبع معتبر در هر زبان پشتیبانی شده است، بررسی کنید. |
---|
نکات پیشگیری | نام منابع را به صورت دستی ایجاد نکنید. از یکی از روشهای کمکی ارائه شده توسط کتابخانههای کلاینت ما استفاده کنید. |
---|
|
|
---|
EMPTY_LIST | خلاصه | یک لیست ضروری خالی است. |
---|
علل شایع | ارسال یک لیست خالی از عملیات به یک متد mutate . |
---|
نحوه رسیدگی | ناموجود |
---|
نکات پیشگیری | ناموجود |
---|
|
|
---|
RESOURCE_EXHAUSTED | خلاصه | از حد فرکانس سیستم تجاوز شده است. |
---|
علل شایع | ناموجود |
---|
نحوه رسیدگی | ناموجود |
---|
نکات پیشگیری | بین درخواستها تأخیرهای کوتاه ایجاد کنید یا عملیات بیشتری را در تعداد درخواستهای کمتری ترکیب کنید. |
---|
|
|
---|
TOO_LOW | خلاصه | یک مقدار کمتر از حداقل مجاز بود. |
---|
علل شایع | فراموش کردن تعیین شناسه، که منجر به ارسال مقدار 0 میشود. |
---|
نحوه رسیدگی | ناموجود |
---|
نکات پیشگیری | به هرگونه محدودیت دامنه که در مرجع API مستند شده است، توجه کنید. |
---|
|
|
---|
INVALID_INPUT | خلاصه | درخواست ناقص است. |
---|
علل شایع | آدرس اینترنتی یا محتوای درخواست ناقص است. |
---|
نحوه رسیدگی | ناموجود |
---|
نکات پیشگیری | ناموجود |
---|
|
REQUIRED_FIELD_MISSING | خلاصه | درخواست فاقد اطلاعات مورد نیاز است. |
---|
علل شایع | هنگام تلاش برای افزودن یک موجودیت، فیلدهای الزامی وجود ندارند. |
---|
نحوه رسیدگی | خطا را ثبت کنید و یک پیام خطا به کاربر ارائه دهید. ویژگی fieldPath خطا نشان میدهد که کدام فیلد از قلم افتاده است. |
---|
نکات پیشگیری | برای اطلاع از فیلدهای مورد نیاز، به مرجع API مراجعه کنید. |
---|
|
|
---|
RESOURCE_LIMIT | خلاصه | این درخواست در تلاش است منبعی ایجاد کند که باعث شود تعداد کل آن منابع از حد مشخصی فراتر رود. |
---|
علل شایع | محدودیتهای متعددی در تعداد منابعی که میتوانند در زمینههای خاص وجود داشته باشند، وجود دارد. |
---|
نحوه رسیدگی | با بررسی محدودیتهای سیستم، محدودیتی را که با آن مواجه هستید شناسایی کنید. یا از یک منبع موجود دوباره استفاده کنید، یا منابع را حذف کنید تا فضای بیشتری برای منابع جدید ایجاد شود. |
---|
نکات پیشگیری | از کوئریهای جستجو برای نظارت بر تعداد منابعی که محدودیت دارند استفاده کنید. |
---|
|
|
---|
TOO_LONG | خلاصه | رشته اختصاص داده شده به فیلد مشخص شده طولانی تر از حد مجاز است. |
---|
علل شایع | تیترها یا توضیحات تبلیغات حاوی متن زیادی هستند. |
---|
نحوه رسیدگی | محدودیتی که با آن مواجه میشوید را شناسایی کنید، رشته را بر اساس آن تغییر دهید و درخواست را دوباره ارسال کنید. |
---|
نکات پیشگیری | از محدودیتهای طول رشته آگاه باشید. |
---|
|
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-10-16 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-10-16 بهوقت ساعت هماهنگ جهانی."],[],[]]