الأخطاء الشائعة

تسرد هذه الصفحة الأخطاء الشائعة وتقدّم نصائح حول كيفية منعها والتعامل معها. للحصول على قائمة كاملة بالأخطاء، يُرجى مراجعة مرجع الأخطاء أو دليل فهم أخطاء واجهة برمجة التطبيقات أو دليل أنواع الأخطاء. للمزيد من المساعدة، يُرجى التواصل مع فريق دعم Google Ads API.

google.rpc.ErrorInfo

ACCESS_TOKEN_SCOPE_INSUFFICIENT
ملخّصلا يتضمّن رمز الدخول OAuth 2.0 النطاقات المطلوبة.
الأسباب الشائعة تم رفض الطلب لأنّ رمز الدخول المقدَّم لا يتضمّن نطاق OAuth 2.0 في Google Ads API.
طريقة التعامل تأكَّد من أنّ رمز الدخول يتضمّن النطاقات المطلوبة. من الأسباب الشائعة لهذا الخطأ هو إعادة استخدام رمز الدخول حالي تم إنشاؤه باستخدام مجموعة مختلفة من نطاقات OAuth. يمكنك الاطّلاع على مَعلمات تفويض OAuth للحصول على مثال على كيفية إنشاء رمز دخول جديد باستخدام النطاقات المطلوبة.
نصائح للوقاية من الفيروس تأكَّد من أنّ رمز الدخول يتضمّن النطاقات المطلوبة. أعِد مصادقة المستخدم باستخدام النطاقات المطلوبة للحصول على إذن وصول بالنطاقات المطلوبة. إذا كان تطبيقك يستخدم عدة نطاقات OAuth، قد تحتاج إلى تنفيذ أذونات OAuth الدقيقة.

google.auth.exceptions.RefreshError

invalid_grant
ملخّصانتهت صلاحية الرمز المميّز أو تم إبطاله.
الأسباب الشائعة يتم إصدار رمز مميز لإعادة التحميل تنتهي صلاحيته بعد 7 أيام لمشروع Google Cloud Platform يتضمّن شاشة طلب موافقة OAuth تم ضبطها لنوع مستخدم خارجي وحالة نشر Testing.
طريقة التعامل حالة النشر لمشروعك على Google هي Testing، لذا تنتهي صلاحية الرمز المميز لإعادة التحميل كل 7 أيام ويظهر الخطأ invalid_grant. انتقِل إلى Google API Console وانتقِل إلى شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth. بعد ذلك، غيِّر حالة النشر إلى In production لتجنُّب انتهاء صلاحية الرمز المميز لإعادة التحميل خلال 7 أيام.
نصائح للوقاية من الفيروس يُرجى الاطّلاع على التطبيقات التي لم يتم التحقّق منها.

AdError

CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR
ملخّصلا يمكن استخدام عامل التشغيل هذا مع فئة فرعية من Ad.
الأسباب الشائعة محاولة تعديل سمات أخرى غير status للإعلان
طريقة التعامل لا ينطبق
نصائح للوقاية من الفيروس بعد إنشاء الإعلان، لا يمكن تعديله. إذا أردت تعديل الإعلان، عليك إنشاء إعلان جديد ثم إزالة الإعلان القديم. ومع ذلك، يمكن تعديل status الإعلان باستخدام MutateAdGroupAds.
INVALID_INPUT
ملخّصيحتوي أحد الحقول في الإعلان على أحرف غير صالحة.
الأسباب الشائعة استخدام أحرف خاصة في عناوين URL
طريقة التعامل لا ينطبق
نصائح للوقاية من الفيروس تحقَّق من صحة عناوين URL في تطبيقك قبل إرسال طلب البيانات من واجهة برمجة التطبيقات.
LINE_TOO_WIDE
ملخّصكان أحد الحقول في الإعلان أطول من الحد الأقصى المسموح به. مزيد من المعلومات عن الإعلانات النصية
الأسباب الشائعة وجود سطر نص طويل جدًا.
طريقة التعامل لا ينطبق
نصائح للوقاية من الفيروس يُرجى التحقّق من طول السطر قبل إرسال طلب البيانات من واجهة برمجة التطبيقات.

AdGroupAdError

AD_GROUP_AD_LABEL_ALREADY_EXISTS
ملخّصهذا التصنيف مقترن سلفًا ببعض الإعلانات.
الأسباب الشائعة محاولة ربط التصنيف بإعلانات سبق ربطها
طريقة التعامل لا ينطبق
نصائح للوقاية من الفيروس تحقَّق أولاً مما إذا كان التصنيف المطلوب إضافته مرتبطًا بالإعلانات.
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD
ملخّصحاولت إحدى العمليات تعديل إعلان تمّت إزالته.
الأسباب الشائعة بعد إزالة إعلان، لا يمكن تعديله بعد ذلك، بما في ذلك إجراء تغييرات على حالته.
طريقة التعامل لا ينطبق
نصائح للوقاية من الفيروس تأكَّد من أنّ الرمز لا يحاول تعديل الإعلانات التي تمت إزالتها.

AdGroupCriterionError

INVALID_KEYWORD_TEXT
ملخّصيحتوي نص الكلمة الرئيسية على أحرف غير صالحة. يُرجى الاطّلاع على إضافة كلمات رئيسية.
الأسباب الشائعة يحتوي نص الكلمة الرئيسية على أحرف غير صالحة.
طريقة التعامل لا ينطبق
نصائح للوقاية من الفيروس تحقَّق من صحة نص الكلمة الرئيسية في تطبيقك قبل إرسال طلب إلى واجهة برمجة التطبيقات.

AdGroupError

DUPLICATE_ADGROUP_NAME
ملخّصتتم إضافة مجموعة إعلانية أو إعادة تسميتها، ولكن الاسم مستخدَم حاليًا من قِبل مجموعة إعلانية أخرى.
الأسباب الشائعة إنشاء مجموعة إعلانية جديدة باسم مجموعة إعلانية حالية نشطة أو متوقفة مؤقتًا
طريقة التعامل سجِّل الخطأ واعرِض رسالة خطأ للمستخدم، واقترِح اختياريًا اسمًا فريدًا للمجموعة الإعلانية أو اعرِض قائمة الأسماء المستخدَمة.
نصائح للوقاية من الفيروس لا ينطبق

AssetError

DUPLICATE_ASSET
ملخّصتحتوي عمليتان في طلب واحد على عملية إنشاء مادة عرض تتضمّن البيانات الثنائية نفسها.
الأسباب الشائعة طلب تغيير يتضمّن عمليات إنشاء مكرّرة تحتوي على البيانات الثنائية نفسها.
طريقة التعامل أنشِئ مادة العرض في طلب منفصل، ثم اربطها بالطلب اللاحق، أو استخدِم معرّفًا مؤقتًا ضمن الطلب نفسه.
نصائح للوقاية من الفيروس لا ينطبق

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
ملخّصالرقم التعريفي للعميل ليس رقمًا.
الأسباب الشائعة استخدام رقم تعريف عميل غير صحيح
طريقة التعامل لا ينطبق
نصائح للوقاية من الفيروس يجب أن يكون الرقم 123-456-7890 بالتنسيق 1234567890. لمزيد من التفاصيل، يُرجى الاطّلاع على البدء.
CLIENT_CUSTOMER_ID_IS_REQUIRED
ملخّصلم يتم تحديد الرقم التعريفي للعميل في عنوان HTTP.
الأسباب الشائعة عدم تحديد رقم تعريف عميل مباشر وعميل غير مباشر في عنوان HTTP
طريقة التعامل لا ينطبق
نصائح للوقاية من الفيروس يجب توفير الرقم التعريفي للعميل في جميع الطلبات، لذا تأكَّد من تحديده في عنوان HTTP. ننصحك باستخدام مكتبات العملاء لأنّها تتولّى هذه المهمة نيابةً عنك.
CUSTOMER_NOT_FOUND
ملخّصلم يتم العثور على حساب لرقم تعريف العميل المقدَّم في العنوان.
الأسباب الشائعة محاولة الوصول إلى حساب تم إنشاؤه للتو قبل إنشاء الحساب في الخلفية.
طريقة التعامل انتظِر لمدة خمس دقائق في البداية، ثم أعِد المحاولة كل 30 ثانية.
نصائح للوقاية من الفيروس يُرجى الانتظار بضع دقائق بعد إنشاء الحساب قبل إرسال طلبات إليه.
ملخّصرمز الدخول في عنوان الطلب غير صالح أو انتهت صلاحيته.
الأسباب الشائعة تم إبطال رمز الدخول.
طريقة التعامل اطلب رمزًا مميّزًا جديدًا. إذا كنت تستخدم إحدى مكتبات العملاء، يمكنك الرجوع إلى مستنداتها حول كيفية إعادة تحميل الرمز المميّز.
نصائح للوقاية من الفيروس خزِّن رموز الدخول وأعِد استخدامها إلى أن تنتهي صلاحيتها.
NOT_ADS_USER
ملخّصحساب Google المستخدَم لإنشاء رمز الدخول غير مرتبط بأي حساب على "إعلانات Google".
الأسباب الشائعة تتوافق معلومات تسجيل الدخول المقدَّمة مع حساب Google غير مفعَّل فيه "إعلانات Google".
طريقة التعامل تأكَّد من تسجيل الدخول باستخدام حساب صالح على "إعلانات Google" (عادةً ما يكون حسابك الإداري) لتدفق OAuth. يمكنك أيضًا دعوة حساب Google للوصول إلى حساب حالي على "إعلانات Google" من خلال تسجيل الدخول إلى حسابك الإداري، واختيار حساب العميل أو الحساب الإداري المعني، والانتقال إلى Tools and Settings > Access and security، ثم إضافة عنوان البريد الإلكتروني لحساب Google.
نصائح للوقاية من الفيروس لا ينطبق
OAUTH_TOKEN_INVALID
ملخّصرمز الدخول OAuth في العنوان غير صالح.
الأسباب الشائعة الرمز المميز للوصول الذي تم تمريره مع عنوان HTTP غير صحيح.
طريقة التعامل لا ينطبق
نصائح للوقاية من الفيروس تأكَّد من تمرير رمز الدخول الصحيح المرتبط بحسابك. ويتم أحيانًا الخلط بينه وبين الرموز المميزة لإعادة التحميل ورموز التفويض. إذا أردت الحصول على بيانات اعتماد يمكنها الوصول إلى جميع حسابات العملاء ضمن حساب مدير، تأكَّد من الحصول على الرمز المميز لإعادة التحميل لحساب المدير. يُرجى الاطّلاع على دليل مصادقة المستخدم.

AuthorizationError

CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
ملخّصيملك مشروع Google Cloud إذن وصول تجريبي فقط ولا يمكن استخدامه للوصول إلى حسابات الإنتاج.
الأسباب الشائعة تم استخدام مشروع على السحابة الإلكترونية من Google Cloud مع مستوى الوصول التجريبي لتقديم طلب إلى حساب "إعلانات Google" غير تجريبي (إنتاج). (في الإصدارات v24 والإصدارات الأقدم من واجهة برمجة التطبيقات، يعرض هذا الشرط القيمة AuthorizationError.ACTION_NOT_PERMITTED).
طريقة التعامل إذا كنت تجري اختبارًا، تأكَّد من أنّ طلبك يستهدف حسابًا اختباريًا. إذا أردت الوصول إلى حساب إنتاج على "إعلانات Google"، تحقَّق من مستوى وصول مشروعك على Google Cloud في صفحة "نظرة عامة" في Google Ads API ورقِّ مستوى وصول مشروعك إلى "المستكشف" أو "الوصول الأساسي" أو "الوصول العادي".
نصائح للوقاية من الفيروس لا ينطبق
CUSTOMER_NOT_ENABLED
ملخّصلا يمكن الوصول إلى حساب العميل لأنّه ليس في حالة مفعَّلة.
الأسباب الشائعة يحدث ذلك عندما لا يكون حساب العميل قد أكمل عملية الاشتراك أو تم إيقافه.
طريقة التعامل سجِّل الدخول إلى واجهة مستخدم "إعلانات Google" وتأكَّد من إكمال عملية الاشتراك لهذا الحساب. بالنسبة إلى الحسابات التي تم إيقافها، يُرجى الاطّلاع على مقالة إعادة تفعيل حساب مُلغى على "إعلانات Google".
نصائح للوقاية من الفيروس يمكنك التحقّق بشكل استباقي مما إذا تم إيقاف حساب عميل من خلال البحث عن الحالة CANCELLED.
USER_PERMISSION_DENIED
ملخّصلا يملك العميل المفوَّض إذن الوصول إلى العميل المشغِّل.
الأسباب الشائعة المصادقة كمستخدم لديه إذن الوصول إلى حساب إداري ولكن بدون تحديد login-customer-id في الطلب
طريقة التعامل لا ينطبق
نصائح للوقاية من الفيروس حدِّد login-customer-id كرقم تعريف الحساب الإداري بدون واصلات (-). تتضمّن مكتبات العملاء دعمًا مدمجًا لذلك.

BiddingError

BID_TOO_MANY_FRACTIONAL_DIGITS
ملخّصقيمة عرض السعر ليست من مضاعفات الحد الأدنى لوحدة عملة الحساب. على سبيل المثال، لا يُعدّ عرض السعر 0.015 دولار أمريكي (15000 بالوحدات الصغرى) صالحًا.
الأسباب الشائعة لا ينطبق
طريقة التعامل لا ينطبق
نصائح للوقاية من الفيروس تأكَّد من أنّ عروض الأسعار هي من مضاعفات الحدّ الأدنى للوحدة لعملة الحساب.
BID_TOO_BIG
ملخّصيتم عرض الخطأ على الرغم من أنّ عرض السعر يقع ضمن ميزانية الحملة.
الأسباب الشائعة لا ينطبق
طريقة التعامل لا ينطبق
نصائح للوقاية من الفيروس تحقَّق مما إذا كان الحساب مشاركًا في برنامج منحة إعلانية من Google. إذا كان الأمر كذلك، يمكنك حصر عروض أسعار النقرة على الحدّ الأقصى الذي يحدّده البرنامج.

CampaignBudgetError

MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC
ملخّصمبلغ الميزانية صغير جدًا.
الأسباب الشائعة لا ينطبق
طريقة التعامل لا ينطبق
نصائح للوقاية من الفيروس يُرجى التأكّد من أنّ مبلغ الميزانية أكبر من أو يساوي الحدّ الأدنى للوحدة لعملة الحساب.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT
ملخّصسيحتوي مبلغ الميزانية على عدد كبير جدًا من المنازل العشرية المهمة عند تحويله من مبلغ صغير إلى مبلغ بعملة الحساب.
الأسباب الشائعة لا ينطبق
طريقة التعامل لا ينطبق
نصائح للوقاية من الفيروس يُرجى التأكّد من أنّ مبلغ الميزانية يقبل القسمة على الحدّ الأدنى للوحدة لعملة الحساب.

CampaignError

DUPLICATE_CAMPAIGN_NAME
ملخّصتتم إضافة حملة أو إعادة تسميتها، ولكن الاسم مستخدَم حاليًا في حملة أخرى.
الأسباب الشائعة إنشاء حملة جديدة باسم حملة حالية نشطة أو متوقفة مؤقتًا
طريقة التعامل سجِّل الخطأ واعرِض رسالة خطأ للمستخدم، واقترِح اختياريًا اسم حملة فريدًا أو اعرِض قائمة الأسماء المستخدَمة.
نصائح للوقاية من الفيروس لا ينطبق
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE
ملخّصمحاولة تغيير إعداد نوع مطابقة الكلمات الرئيسية على مستوى الحملة في حملة تم تفعيل ميزات AI Max فيها
الأسباب الشائعة عند تفعيل AI Max، يتم إيقاف إعدادات المطابقة التقريبية على مستوى الحملة نهائيًا لأنّ جميع الكلمات الرئيسية تُعامل على أنّها تستخدم المطابقة التقريبية تلقائيًا. ستؤدي محاولة ضبط هذا الحقل أو تعديله إلى ظهور الخطأ.
طريقة التعامل يجب نصح المستخدم باستخدام مَعلمة disable_search_term_matching على مستوى المجموعة الإعلانية بدلاً من ضبط المطابقة التقريبية على مستوى الحملة.
نصائح للوقاية من الفيروس تجنَّب ضبط `keyword_match_type` على `BROAD` (أو أي قيمة أخرى) في الحملة إذا تم ضبط `ai_max_setting.enable_ai_max` على `true`. فعِّل ميزة "مطابقة عبارات البحث" أو أوقِفها على مستوى المجموعة الإعلانية باستخدام `disable_search_term_matching`.

CriterionError

KEYWORD_HAS_INVALID_CHARS
ملخّصإضافة كلمات رئيسية تحتوي على أحرف غير صالحة أو تعديلها
الأسباب الشائعة استخدام رموز خاصة مثل ! @ % * في الكلمات الرئيسية
طريقة التعامل لا ينطبق
نصائح للوقاية من الفيروس تأكَّد من عدم استخدام أي أحرف غير مسموح بها في الكلمات الرئيسية. يُرجى الاطّلاع على إضافة كلمات رئيسية.

DemandGenCampaignError

CANNOT_ACTIVATE_MIGRATED_CAMPAIGN
ملخّصلا يمكن تفعيل "حملة زيادة طلب" تم نقلها قبل إزالة الحملة الأصلية، أو عندما تكون هناك حملة أخرى تم نقلها للحملة الأصلية نفسها نشطة حاليًا.
الأسباب الشائعة تعديل status "حملة زيادة الطلب" التي تم نقلها إلى ENABLED في حال عدم إزالة الحملة المصدر الأصلية أو في حال كانت "حملة زيادة الطلب" الأخرى التي تم نقلها من الحملة الأصلية نفسها قد تم ENABLED. في الإصدارات v25 من واجهة برمجة التطبيقات والإصدارات الأقدم، يعرض هذا الشرط RequestError.UNKNOWN.
طريقة التعامل أزِل الحملة المصدر الأصلية باستخدام CampaignOperation.remove (إما مسبقًا أو في طلب التغيير نفسه) قبل تفعيل "حملة زيادة الطلب" التي تم نقلها، وتأكَّد من عدم تفعيل أي "حملة زيادة طلب" أخرى تم نقلها من الحملة الأصلية نفسها. يُرجى الاطّلاع على مقالة تفعيل الحملات التي تم نقلها لمزيد من التفاصيل.
نصائح للوقاية من الفيروس إذا كنت تتتبّع أرقام تعريف حملاتك المصدر الأصلية و"حملات زيادة الطلب" التي تم نقلها، يمكنك الاستعلام عن campaign.status قبل ضبط status على ENABLED في حملة تم نقلها، أو تضمين CampaignOperation.remove للحملة الأصلية في طلب التغيير نفسه.

DistinctError

DUPLICATE_ELEMENT
ملخّصيحتوي الطلب على مَعلمتَين متطابقتَين ومكرّرتَين.
الأسباب الشائعة لا ينطبق
طريقة التعامل لا ينطبق
نصائح للوقاية من الفيروس يُرجى إزالة النُسخ المكرّرة (العمليات والمَعلمات وعناصر القائمة) قبل إرسال الطلب. ابحث عن الحقول التي تحتوي على القيد DistinctElements.

InternalError

DEADLINE_EXCEEDED
ملخّصانتهت مهلة الطلب وتعذّر إكماله بسرعة كافية لإرسال ردّ.
الأسباب الشائعة تم إجراء طلب بحث أدّى إلى إنشاء ردّ كبير جدًا، أو كان طلب التغيير كبيرًا جدًا بحيث لا يمكن معالجته.
طريقة التعامل انتظِر لمدة 30 ثانية تقريبًا، ثم أعِد محاولة إجراء الطلب. إذا استمر الخطأ، حاوِل تقسيم الطلب إلى طلبات متعددة أصغر حجمًا يمكن إكمالها بسرعة أكبر.
نصائح للوقاية من الفيروس راجِع التقسيم لفهم كيف يمكن أن يؤثر في حجم الردّ. يُرجى الانتباه إلى قيود طبقة النقل في gRPC.
INTERNAL_ERROR
ملخّصحدث خطأ غير متوقع أثناء معالجة الطلب.
الأسباب الشائعة لا تعمل واجهة برمجة التطبيقات بشكل صحيح بسبب خطأ.
طريقة التعامل أعِد محاولة إرسال أي طلبات تعذّر تنفيذها بسبب هذا الخطأ، باستخدام جدول زمني لخوارزمية الرقود الأسي الثنائي لإعادة المحاولة.
نصائح للوقاية من الفيروس لا ينطبق
TRANSIENT_ERROR
ملخّصحدث خطأ داخلي عابر، ويجب إعادة المحاولة.
الأسباب الشائعة يحدث هذا الخطأ عندما تواجه واجهة برمجة التطبيقات مشكلة مؤقتة داخليًا.
طريقة التعامل أعِد محاولة إرسال أي طلبات تعذّر تنفيذها بسبب هذا الخطأ، باستخدام جدول زمني لخوارزمية الرقود الأسي الثنائي لإعادة المحاولة.
نصائح للوقاية من الفيروس لا ينطبق

InvalidGrantError

invalid_grant (malformed auth code)
ملخّصكان رمز التفويض الذي تم تبادله برموز OAuth المميّزة غير صالح.
الأسباب الشائعة يحدث ذلك عند محاولة إنشاء رمز مميز لإعادة التحميل لمستخدم سبق أن تم منحه إذن الوصول إلى التطبيق الذي يطلب ذلك. على سبيل المثال، يمكن أن يحدث ذلك عند تشغيل مثال إنشاء بيانات اعتماد المستخدم أكثر من مرة لبيانات اعتماد عميل OAuth نفسها والمستخدم المفوَّض.
طريقة التعامل لإعادة إنشاء رمز مميّز لإعادة التحميل لمجموعة معيّنة من بيانات اعتماد المستخدم المفوِّض وعميل OAuth، عليك إبطال رمز مميّز حالي لإعادة التحميل. يُرجى العِلم أنّ إبطال رمز مميّز يجعله غير صالح للاستخدام للوصول إلى Google Ads API، كما يؤدي إلى إبطال أي رموز مميّزة للوصول تم استخدام الرمز المميّز لإعادة التحميل لإنشائها.
نصائح للوقاية من الفيروس احرص على تخزين الرمز المميز لإعادة التحميل في مكان آمن لتجنُّب الحاجة إلى إعادة إنشائه.

MutateError

RESOURCE_NOT_FOUND
ملخّصأشار الطلب إلى مورد تعذّر العثور عليه.
الأسباب الشائعة حاول الطلب تغيير مورد غير موجود أو تمت إزالته أو الإشارة إليه بطريقة أخرى. أو أنّ اسم المورد المحدّد غير صالح.
طريقة التعامل استخدِم طلب بحث لاسترداد اسم مورد حالي قبل إرسال طلب تغيير. راجِع أدلة مكتبة برامج العميل التي تتضمّن مستندات حول كيفية إنشاء أسماء موارد صالحة بكل لغة متاحة
نصائح للوقاية من الفيروس لا تنشئ أسماء الموارد يدويًا. استخدِم إحدى الطرق المساعدة التي توفّرها مكتبات العملاء.

NotEmptyError

EMPTY_LIST
ملخّصهناك قائمة مطلوبة فارغة.
الأسباب الشائعة تمرير قائمة فارغة من العمليات إلى طريقة mutate.
طريقة التعامل لا ينطبق
نصائح للوقاية من الفيروس لا ينطبق

QuotaError

RESOURCE_EXHAUSTED
ملخّصتم تجاوز الحد الأقصى لعدد مرات الظهور في النظام.
الأسباب الشائعة لا ينطبق
طريقة التعامل لا ينطبق
نصائح للوقاية من الفيروس يمكنك إعداد فترات تأخير قصيرة بين الطلبات أو دمج المزيد من العمليات في عدد أقل من الطلبات.

RangeError

TOO_LOW
ملخّصكانت القيمة أقل من الحد الأدنى المسموح به.
الأسباب الشائعة نسيان تحديد معرّف، ما يؤدي إلى تمرير قيمة 0
طريقة التعامل لا ينطبق
نصائح للوقاية من الفيروس يُرجى الانتباه إلى أي قيود على النطاق موضّحة في مرجع واجهة برمجة التطبيقات.

RequestError

INVALID_INPUT
ملخّصتمت صياغة الطلب بشكل غير صحيح.
الأسباب الشائعة عنوان URL أو محتوى الطلب غير صحيح.
طريقة التعامل لا ينطبق
نصائح للوقاية من الفيروس لا ينطبق
REQUIRED_FIELD_MISSING
ملخّصلا يتضمن الطلب بعض المعلومات المطلوبة.
الأسباب الشائعة الحقول المطلوبة غير متوفّرة عند محاولة إضافة كيان.
طريقة التعامل سجِّل الخطأ واعرِض رسالة خطأ للمستخدم. تشير السمة fieldPath للخطأ إلى الحقل غير المتوفّر.
نصائح للوقاية من الفيروس يُرجى الرجوع إلى مرجع واجهة برمجة التطبيقات لمعرفة الحقول المطلوبة.

ResourceCountLimitExceededError

RESOURCE_LIMIT
ملخّصيحاول الطلب إنشاء مورد من شأنه أن يؤدي إلى تجاوز إجمالي عدد هذه الموارد حدًا معينًا.
الأسباب الشائعة هناك حدود متعددة لعدد الموارد التي يمكن أن تتوفّر في سياقات معيّنة.
طريقة التعامل حدِّد الحدّ الأقصى الذي تتم مواجهته من خلال مراجعة حدود النظام. يمكنك إعادة استخدام مورد حالي أو إزالة موارد لإفساح المجال لموارد جديدة.
نصائح للوقاية من الفيروس استخدِم طلبات البحث لمراقبة عدد الموارد التي تتضمّن قيودًا.

StringLengthError

TOO_LONG
ملخّصالسلسلة المخصّصة للحقل المحدّد أطول من الحدّ المسموح به.
الأسباب الشائعة تحتوي عناوين الإعلانات أو أوصافها على نص طويل جدًا.
طريقة التعامل حدِّد الحدّ الذي تم تجاوزه، وعدِّل السلسلة وفقًا لذلك، ثم أعِد إرسال الطلب.
نصائح للوقاية من الفيروس يُرجى الانتباه إلى حدود طول السلسلة.