خطاهای رایج

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

google.rpc.ErrorInfo

ACCESS_TOKEN_SCOPE_INSUFFICIENT

خلاصه کد دسترسی OAuth 2.0 دامنه‌های لازم را ندارد. دلایل متداول درخواست رد شد زیرا کد دسترسی ارائه‌شده شامل دامنه Google Ads API OAuth 2.0 نیست. نحوه رسیدگی مطمئن شوید که کد دسترسی دارای دامنه‌های لازم باشد. دلیل رایج این خطا این است که شما از یک کد دسترسی موجود که بااستفاده از مجموعه متفاوتی از دامنه‌های OAuth تولید شده است، مجدداً استفاده می‌کنید. برای دیدن نمونه‌ای از نحوه تولید کد دسترسی جدید با دامنه‌های لازم، پارامترهای مجوز OAuth را ببینید. نکات پیشگیری مطمئن شوید که کد دسترسی دارای دامنه‌های لازم باشد. کاربرتان را با دامنه‌های لازم دوباره اصالت‌سنجی کنید تا با دامنه‌های لازم دسترسی پیدا کنید. اگر برنامه‌تان از چند دامنه OAuth استفاده می‌کند، ممکن است لازم باشد اجازه‌های OAuth جزئی را پیاده‌سازی کنید.

google.auth.exceptions.RefreshError

invalid_grant

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

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	خلاصه از این اپراتور نمی‌توان با زیرکلاس Ad استفاده کرد. دلایل متداول تلاش برای اصلاح مشخصه‌هایی غیراز status آگهی. نحوه رسیدگی نامشخص نکات پیشگیری وقتی آگهی ایجاد شد، نمی‌توان آن را تغییر داد. اگر می‌خواهید آگهی را اصلاح کنید، باید آگهی جدیدی بسازید و سپس آگهی قدیمی را بردارید. بااین‌حال، status آگهی بااستفاده از MutateAdGroupAds قابل‌تغییر است.
INVALID_INPUT	خلاصه یکی از فیلدهای آگهی حاوی نویسه‌های نامعتبر است. دلایل متداول استفاده از نویسه‌های خاص در نشانی‌های وب. نحوه رسیدگی نامشخص نکات پیشگیری پیش‌از درخواست میانای برنامه‌سازی کاربردی، نشانی‌های وب را در برنامه‌تان اعتبارسنجی کنید.
LINE_TOO_WIDE	خلاصه یکی از فیلدهای آگهی از حداکثر طول مجاز بیشتر بود. درباره آگهی‌های نوشتاری را ببینید. دلایل متداول داشتن خط نوشتاری بیش‌ازحد طولانی. نحوه رسیدگی نامشخص نکات پیشگیری پیش‌از درخواست API، طول خط را اعتبارسنجی کنید.

AdGroupAdError
AD_GROUP_AD_LABEL_ALREADY_EXISTS	خلاصه این برچسب قبلاً با برخی‌از آگهی‌ها مرتبط شده است. دلایل متداول تلاش برای مرتبط کردن برچسب با آگهی‌هایی که قبلاً مرتبط شده‌اند. نحوه رسیدگی نامشخص نکات پیشگیری ابتدا بررسی کنید که برچسبی که می‌خواهید اضافه کنید ازقبل با آگهی‌ها مرتبط است یا نه.
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD	خلاصه عملیاتی برای به‌روزرسانی آگهی برداشته‌شده انجام شد. دلایل متداول وقتی آگهی برداشته شود، دیگر نمی‌توان آن را به‌روز کرد—ازجمله تغییر وضعیت آن. نحوه رسیدگی نامشخص نکات پیشگیری مطمئن شوید که کد شما برای به‌روزرسانی آگهی‌های برداشته‌شده تلاش نمی‌کند.

AdGroupCriterionError
INVALID_KEYWORD_TEXT	خلاصه نوشتار کلیدواژه حاوی نویسه‌های نامعتبر است. افزودن کلیدواژه را ببینید. دلایل متداول نوشتار کلیدواژه حاوی نویسه‌های نامعتبر است. نحوه رسیدگی نامشخص نکات پیشگیری پیش‌از درخواست دادن به میانای برنامه‌سازی کاربردی، نوشتار کلیدواژه را در برنامه‌تان اعتبارسنجی کنید.

AdGroupError
DUPLICATE_ADGROUP_NAME	خلاصه گروه آگهی‌ای درحال اضافه شدن یا تغییر نام است، اما نام آن قبلاً توسط گروه آگهی دیگری استفاده شده است. دلایل متداول ایجاد گروه آگهی جدید با نام گروه آگهی فعال یا موقتاً متوقف‌شده موجود. نحوه رسیدگی خطا را ثبت کنید و پیام خطایی به کاربر نشان دهید، و به‌طور اختیاری نام منحصربه‌فردی برای گروه آگهی پیشنهاد دهید یا فهرست نام‌های درحال استفاده را نشان دهید. نکات پیشگیری نامشخص

AssetError
DUPLICATE_ASSET	خلاصه دو عملیات در یک درخواست حاوی عملیات ایجاد برای دارایی با داده‌های دودویی یکسان است. دلایل متداول درخواست تغییر با عملیات ایجاد تکراری که حاوی داده‌های دودویی یکسان است. نحوه رسیدگی دارایی را در درخواستی جداگانه ایجاد کنید، سپس در درخواست بعدی به آن پیوند دهید؛ یا از شناسه موقت در همان درخواست استفاده کنید. نکات پیشگیری نامشخص
PARTNER_PROMOTION_ID_TYPE_INCOMPATIBLE	خلاصه شناسه تبلیغ شریک از نوع oneof (int_value یا string_value) استفاده می‌کند که ادغام تبلیغ حساب آن را نمی‌پذیرد. دلایل متداول تنظیم فیلد promotion_asset.external_redeem_info.partner_promotion_id.int_value وقتی که ادغام پس‌خرید مشتری به نوع string_value نیاز دارد، یا تنظیم فیلد string_value وقتی که ادغام به نوع int_value نیاز دارد. نحوه رسیدگی درخواست ایجاد را به‌روز کنید تا گونه ExternalPartnerId (int_value یا string_value) پذیرفته‌شده توسط ادغام تبلیغات ویژه حساب را پر کند. برای جزئیات، به ردیابی پس‌خرید تبلیغ ویژه خارجی مراجعه کنید. نکات پیشگیری قبل‌از ایجاد پیام PromotionAsset با فیلد external_redeem_info، تأیید کنید که ادغام پس‌خرید پایانه فروش (POS) شما از کدام قالب شناسه تبلیغ (int_value یا string_value) استفاده می‌کند.

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	خلاصه شناسه مشتری کارخواه عدد نیست. دلایل متداول استفاده از شناسه مشتری کارخواه نامناسب. نحوه رسیدگی نامشخص نکات پیشگیری ‫123-456-7890 باید 1234567890 باشد. برای جزئیات، به شروع به کار مراجعه کنید.
CLIENT_CUSTOMER_ID_IS_REQUIRED	خلاصه شناسه مشتری کارخواه در سرصفحه HTTP مشخص نشده است. دلایل متداول شناسه مشتری کارخواه در سرصفحه HTTP مشخص نشده است. نحوه رسیدگی نامشخص نکات پیشگیری شناسه مشتری کارخواه برای همه تماس‌ها لازم است، بنابراین مطمئن شوید که آن را در سرایند HTTP مشخص کرده‌اید. استفاده از کتابخانه‌های مشتری ما را مدنظر قرار دهید زیرا این کار را برای شما انجام می‌دهند.
CUSTOMER_NOT_FOUND	خلاصه هیچ حسابی برای شناسه مشتری ارائه‌شده در سرصفحه پیدا نشد. دلایل متداول تلاش برای دسترسی به حسابی که به‌تازگی ایجاد شده است، قبل‌از اینکه حساب در پس‌زمینه ایجاد شود. نحوه رسیدگی ابتدا پنج دقیقه صبر کنید، سپس هر ۳۰ ثانیه دوباره امتحان کنید. نکات پیشگیری پس‌از ایجاد حساب، چند دقیقه صبر کنید و سپس درخواست‌های مربوط به آن را صادر کنید.
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 موجود دسترسی پیدا کند. نکات پیشگیری نامشخص
OAUTH_TOKEN_INVALID	خلاصه کد دسترسی OAuth در سرایند معتبر نیست. دلایل متداول کد دسترسی شما که با سرایند HTTP ارسال شده است درست نبود. نحوه رسیدگی نامشخص نکات پیشگیری مطمئن شوید کد دسترسی صحیح مرتبط با حسابتان را ارسال کرده‌اید. گاهی با ژتون بازآوری و کدهای مجوز اشتباه گرفته می‌شود. اگر می‌خواهید اطلاعات اعتباری‌ای دریافت کنید که بتواند به همه حساب‌های مشتری تحت حساب مدیر دسترسی داشته باشد، حتماً ژتون بازآوری را برای حساب مدیر دریافت کنید. راهنمای اصالت‌سنجی کاربر را ببینید.

AuthorizationError
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION	خلاصه پروژه Google Cloud فقط دسترسی «آزمایشی» دارد و نمی‌توان از آن برای دسترسی به حساب‌های تولید استفاده کرد. دلایل متداول از پروژه Google Cloud با سطح دسترسی آزمایشی برای درخواست از حساب Google Ads غیرآزمایشی (تولید) استفاده شده است. (در نسخه‌های میانای برنامه‌سازی کاربردی v24 و قدیمی‌تر، این شرط AuthorizationError.ACTION_NOT_PERMITTED را برمی‌گرداند.) نحوه رسیدگی اگر درحال آزمایش هستید، مطمئن شوید درخواستتان حساب آزمایشی را هدف قرار می‌دهد. اگر می‌خواهید به حساب Google Ads تولیدی دسترسی پیدا کنید، سطح دسترسی پروژه Google Cloud خود را در صفحه نمای کلی Google Ads API بررسی کنید و سطح دسترسی پروژه خود را به دسترسی Explorer، «پایه»، یا «استاندارد» ارتقا دهید. نکات پیشگیری نامشخص
CUSTOMER_NOT_ENABLED	خلاصه دسترسی به حساب مشتری امکان‌پذیر نیست زیرا در وضعیت فعال نیست. دلایل متداول این اتفاق زمانی می‌افتد که حساب مشتری ثبت‌نام را تکمیل نکرده باشد یا غیرفعال شده باشد. نحوه رسیدگی به سیستم واسط کاربر Google Ads وارد شوید و مطمئن شوید که فرایند ثبت‌نام را برای این حساب تکمیل کرده‌اید. برای حساب‌های غیرفعال‌شده، به فعال کردن مجدد حساب Google Ads لغوشده مراجعه کنید. نکات پیشگیری می‌توانید با بررسی وضعیت لغوشده، به‌طور پیش‌گیرانه بررسی کنید که آیا حساب مشتری غیرفعال شده است یا نه.
USER_PERMISSION_DENIED	خلاصه مشتری مجاز به مشتری عامل دسترسی ندارد. دلایل متداول اصالت‌سنجی به‌عنوان کاربری که به حساب مدیر دسترسی دارد اما login-customer-id را در درخواست مشخص نمی‌کند. نحوه رسیدگی نامشخص نکات پیشگیری login-customer-id را به‌عنوان شناسه حساب مدیر بدون خط تیره (-) مشخص کنید. کتابخانه‌های کارخواه از این ویژگی پشتیبانی داخلی دارند.

BiddingError
BID_TOO_MANY_FRACTIONAL_DIGITS	خلاصه مقدار پیشنهاد قیمت مضرب دقیقی از حداقل واحد پول حساب نیست. برای مثال، ۰٫۰۱۵ دلار امریکا (15000 در میکرو) پیشنهاد قیمت معتبری نیست. دلایل متداول نامشخص نحوه رسیدگی نامشخص نکات پیشگیری بررسی کنید که پیشنهادهای قیمت مضربی از حداقل واحد برای واحد پول حساب باشد.
BID_TOO_BIG	خلاصه این خطا حتی زمانی که پیشنهاد قیمت در چارچوب بودجه پویش باشد برگردانده می‌شود. دلایل متداول نامشخص نحوه رسیدگی نامشخص نکات پیشگیری بررسی کنید که آیا حساب در Google Ad Grants شرکت می‌کند یا نه. اگر چنین است، پیشنهادهای قیمت کلیک‌بها را به حداکثر تعیین‌شده توسط برنامه محدود کنید.

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	خلاصه مبلغ بودجه خیلی کم است. دلایل متداول نامشخص نحوه رسیدگی نامشخص نکات پیشگیری بررسی کنید که مبلغ بودجه بزرگ‌تر یا مساوی با حداقل واحد برای واحد پول حساب باشد.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT	خلاصه مبلغ بودجه هنگام تبدیل از مقدار میکرو به مقدار در واحد پول حساب، دارای تعداد زیادی رقم اعشار بااهمیت خواهد بود. دلایل متداول نامشخص نحوه رسیدگی نامشخص نکات پیشگیری بررسی کنید که مبلغ بودجه بر حداقل واحد پول حساب بخش‌پذیر باشد.

CampaignError
DUPLICATE_CAMPAIGN_NAME	خلاصه پویشی درحال اضافه شدن یا تغییر نام است، اما نام آن قبلاً توسط پویش دیگری استفاده شده است. دلایل متداول ایجاد پویش جدید با نام پویش فعال یا موقتاً متوقف‌شده موجود. نحوه رسیدگی خطا را ثبت کنید و پیام خطایی به کاربر نشان دهید، و به‌صورت اختیاری نام کمپین یکتایی پیشنهاد دهید یا فهرست نام‌های درحال استفاده را نشان دهید. نکات پیشگیری نامشخص
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE	خلاصه تلاش برای تغییر تنظیم نوع تطبیق کلیدواژه در سطح پویش در پویشی که «بیشینه‌سازی هوشواره‌ای» در آن فعال است. دلایل متداول با فعال شدن «بیشینه‌سازی هوشواره‌ای»، تنظیمات انطباق تقریبی در سطح پویش منسوخ می‌شوند زیرا همه کلیدواژه‌ها به‌طور پیش‌فرض به‌عنوان انطباق تقریبی درنظر گرفته می‌شوند. تلاش برای تنظیم یا اصلاح این فیلد باعث ایجاد خطا می‌شود. نحوه رسیدگی به کاربر توصیه کنید به‌جای تنظیم انطباق تقریبی در سطح پویش، از پارامتر `disable_search_term_matching` در سطح گروه آگهی استفاده کند. نکات پیشگیری اگر `ai_max_setting.enable_ai_max` روی `true` تنظیم شده است، از تنظیم `keyword_match_type` روی `BROAD` (یا هر مقدار دیگری) در پویش خودداری کنید. تطبیق عبارت جستجو را در سطح گروه آگهی بااستفاده از `disable_search_term_matching` تغییر دهید.

CriterionError
KEYWORD_HAS_INVALID_CHARS	خلاصه افزودن یا ویرایش کلیدواژه‌هایی که حاوی نویسه‌های نامعتبر هستند. دلایل متداول از نویسه‌های خاص مانند ! @ % * در کلیدواژه‌ها استفاده کنید. نحوه رسیدگی نامشخص نکات پیشگیری مطمئن شوید که از نویسه‌های غیرمجاز در کلیدواژه‌ها استفاده نمی‌کنید. افزودن کلیدواژه را ببینید.

DemandGenCampaignError

CANNOT_ACTIVATE_MIGRATED_CAMPAIGN

خلاصه پویش «تولید تقاضا» منتقل‌شده را نمی‌توان قبل‌از برداشته شدن پویش اصلی فعال کرد، یا وقتی پویش منتقل‌شده دیگری برای همان پویش اصلی درحال‌حاضر فعال است. دلایل متداول به‌روزرسانی status پویش «تولید تقاضا» منتقل‌شده به ENABLED وقتی پویش مبدأ اصلی برداشته نشده است یا پویش «تولید تقاضا» دیگری که از همان پویش اصلی منتقل شده است ازقبل ENABLED است. در نسخه‌های API‏ v25 و قدیمی‌تر، این شرط RequestError.UNKNOWN را برمی‌گرداند. نحوه رسیدگی قبل‌از فعال کردن پویش «تولید تقاضا» انتقال‌یافته، پویش مبدأ اصلی را بااستفاده از CampaignOperation.remove (یا ازقبل یا در همان درخواست تغییر) بردارید و بررسی کنید که هیچ پویش «تولید تقاضا» دیگری که از همان پویش اصلی انتقال یافته است فعال نباشد. برای جزئیات، فعال کردن پویش‌های انتقال‌یافته را ببینید. نکات پیشگیری اگر شناسه‌های پویش‌های مبدأ اصلی و پویش‌های «تولید تقاضا» منتقل‌شده آن‌ها را ردیابی می‌کنید، قبل‌از تنظیم status روی ENABLED در پویش منتقل‌شده، campaign.status را پُرسمان کنید یا CampaignOperation.remove را برای پویش اصلی در همان درخواست تغییر اضافه کنید.

DistinctError
DUPLICATE_ELEMENT	خلاصه درخواست حاوی دو پارامتر است که یکسان و زائد هستند. دلایل متداول نامشخص نحوه رسیدگی نامشخص نکات پیشگیری قبل‌از ارسال درخواست، موارد تکراری (عملیات، پارامترها، عناصر فهرست) را بردارید. به‌دنبال فیلدهایی بگردید که محدودیت DistinctElements دارند.

InternalError
DEADLINE_EXCEEDED	خلاصه مهلت درخواست تمام شد و به‌اندازه کافی سریع تکمیل نشد تا پاسخی برگرداند. دلایل متداول درخواست جستجویی انجام شده است که پاسخی بسیار بزرگ تولید کرده است، یا درخواست تغییری برای پردازش بیش‌ازحد بزرگ بوده است. نحوه رسیدگی حدود ۳۰ ثانیه صبر کنید، سپس درخواست را دوباره امتحان کنید. اگر خطا برطرف نشد، درخواست را به چند درخواست کوچک‌تر تقسیم کنید تا سریع‌تر تکمیل شود. نکات پیشگیری بخش‌بندی را مرور کنید تا متوجه شوید چگونه می‌تواند بر اندازه پاسخ تأثیر بگذارد. از محدودیت‌های لایه انتقال gRPC آگاه باشید.
INTERNAL_ERROR	خلاصه هنگام پردازش درخواست، اتفاق غیرمنتظره‌ای افتاد. دلایل متداول میانای برنامه‌سازی کاربردی به‌دلیل وجود اشکال به‌درستی کار نمی‌کند. نحوه رسیدگی هر درخواستی را که با این خطا ناموفق بوده است دوباره امتحان کنید و برای امتحان مجدد از زمان‌بندی عقب‌گرد نمایی استفاده کنید. نکات پیشگیری نامشخص
TRANSIENT_ERROR	خلاصه خطای داخلی گذرایی روی داده است و باید دوباره امتحان شود. دلایل متداول این خطا زمانی رخ می‌دهد که میانای برنامه‌سازی کاربردی به‌طور داخلی با مشکل موقتی مواجه شود. نحوه رسیدگی هر درخواستی را که با این خطا ناموفق بوده است دوباره امتحان کنید و برای امتحان مجدد از زمان‌بندی عقب‌گرد نمایی استفاده کنید. نکات پیشگیری نامشخص

InvalidGrantError

invalid_grant (malformed auth code)

خلاصه کد مجوز مبادله‌شده با کد OAuth بدشکل بود. دلایل متداول این اتفاق زمانی می‌افتد که برای کاربری که قبلاً به برنامه درخواست‌کننده دسترسی داشته است، تلاش برای تولید ژتون بازآوری انجام شود. برای مثال، این اتفاق می‌تواند زمانی رخ دهد که نمونه Generate User credentials بیش‌از یک‌بار برای همان اعتبارنامه‌های کارخواه OAuth و کاربر مجاز اجرا شود. نحوه رسیدگی برای تولید مجدد ژتون بازآوری برای ترکیب مشخصی از کاربر مجوزدهنده و اطلاعات کاربری کارخواه OAuth، ژتون بازآوری موجود را لغو کنید. توجه داشته باشید که لغو کردن یک ژتون آن را برای دسترسی به Google Ads API غیرقابل استفاده می‌کند و هر ژتون دسترسی را که ژتون بازآوری برای تولید آن استفاده شده است باطل می‌کند. نکات پیشگیری حتماً ژتون بازآوری را در مکانی امن ذخیره کنید تا نیازی به تولید مجدد آن نباشد.

MutateError

RESOURCE_NOT_FOUND

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

NotEmptyError
EMPTY_LIST	خلاصه یکی‌از فهرست‌های الزامی خالی است. دلایل متداول ارسال فهرست خالی عملیات به روش mutate. نحوه رسیدگی نامشخص نکات پیشگیری نامشخص

QuotaError
RESOURCE_EXHAUSTED	خلاصه از حد بسامد سیستم فراتر رفته است. دلایل متداول نامشخص نحوه رسیدگی نامشخص نکات پیشگیری تأخیرهای کوتاهی بین درخواست‌ها تنظیم کنید یا عملیات بیشتری را در درخواست‌های کمتری ترکیب کنید.

RangeError
TOO_LOW	خلاصه مقداری کمتر از حداقل مجاز بود. دلایل متداول فراموش کردن مشخص کردن شناسه، که منجر به ارسال مقدار 0 می‌شود. نحوه رسیدگی نامشخص نکات پیشگیری به هرگونه محدودیت گستره که در مرجع میانای برنامه‌سازی کاربردی مستند شده است توجه کنید.

RequestError
INVALID_INPUT	خلاصه قالب درخواست درست نیست. دلایل متداول نشانی وب یا محتوای درخواست ناقص است. نحوه رسیدگی نامشخص نکات پیشگیری نامشخص
REQUIRED_FIELD_MISSING	خلاصه اطلاعات الزامی در درخواست وجود ندارد. دلایل متداول فیلدهای الزامی هنگام تلاش برای افزودن نهاد وجود ندارد. نحوه رسیدگی خطا را ثبت کنید و پیام خطایی به کاربر نشان دهید. مشخصه fieldPath خطا نشان می‌دهد کدام فیلد جاافتاده است. نکات پیشگیری برای اطلاع از اینکه کدام فیلدها الزامی هستند، به مرجع میانای برنامه‌سازی کاربردی مراجعه کنید.

ResourceCountLimitExceededError

RESOURCE_LIMIT

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

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