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

تعرض هذه الصفحة الأخطاء الشائعة وتقدّم نصائح حول كيفية منعها والتعامل معها. للحصول على قائمة كاملة بالأخطاء، راجِع مرجع الأخطاء أو دليل فهم أخطاء واجهة برمجة التطبيقات أو دليل أنواع الأخطاء. للحصول على مزيد من المساعدة، يُرجى التواصل مع فريق دعم 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 ثانية. نصائح للوقاية من الفيروس انتظِر بضع دقائق بعد إنشاء الحساب قبل إرسال طلبات إليه.
GOOGLE_ACCOUNT_COOKIE_INVALID	ملخّص رمز الدخول في عنوان الطلب غير صالح أو انتهت صلاحيته. الأسباب الشائعة تم إبطال رمز الدخول. طريقة التعامل اطلب رمزًا مميّزًا جديدًا. إذا كنت تستخدم إحدى مكتبات العملاء، يمكنك الرجوع إلى مستنداتها لمعرفة كيفية إعادة تحميل الرمز المميّز. نصائح للوقاية من الفيروس تخزين رموز الدخول وإعادة استخدامها إلى أن تنتهي صلاحيتها
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" غير تجريبي (إنتاج). (في الإصدارات 24 من واجهة برمجة التطبيقات والإصدارات الأقدم، يعرض هذا الشرط القيمة 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	ملخّص إضافة أو تعديل كلمات رئيسية تحتوي على أحرف غير صالحة الأسباب الشائعة استخدام رموز خاصة مثل ! @ % * في الكلمات الرئيسية طريقة التعامل لا ينطبق نصائح للوقاية من الفيروس تأكَّد من عدم استخدام أي أحرف غير مسموح بها في الكلمات الرئيسية. كيفية إضافة كلمات رئيسية

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	ملخّص السلسلة المعيّنة للحقل المحدّد أطول من الحدّ الأقصى المسموح به. الأسباب الشائعة تحتوي عناوين الإعلانات أو أوصافها على نص طويل جدًا. طريقة التعامل حدِّد الحدّ الذي يتمّ مواجهته، وعدِّل السلسلة وفقًا لذلك، ثمّ أعِد إرسال الطلب. نصائح للوقاية من الفيروس انتبه إلى الحدود القصوى لطول السلسلة.