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

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

google.auth.exceptions.RefreshError

invalid_grant

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

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

AuthorizationError
CUSTOMER_NOT_ENABLED	ملخّص لا يمكن الوصول إلى حساب العميل لأنه ليس في حالة مفعّلة. الأسباب الشائعة ويحدث ذلك في حال عدم اكتمال اشتراك حساب العميل أو إلغاء تفعيله. كيفية التعامل مع الجهاز سجِّل الدخول إلى واجهة مستخدم "إعلانات Google" وتأكّد من إكمال عملية الاشتراك لهذا الحساب. بالنسبة إلى الحسابات غير المفعَّلة، يُرجى الاطّلاع على إعادة تفعيل حساب مُلغى على "إعلانات Google". نصائح للوقاية من الفيروس يمكنك التحقّق بشكل استباقي ممّا إذا كان حساب العميل قد تم إيقافه عن طريق التحقّق من الحالة تم الإلغاء.
DEVELOPER_TOKEN_NOT_APPROVED	ملخّص تمت الموافقة على استخدام الرمز المميز للمطوِّر مع الحسابات التجريبية فقط، كما تمت محاولة الوصول إلى حساب غير تجريبي. الأسباب الشائعة تم استخدام رمز مميّز للمطوِّر للاختبار من أجل الوصول إلى حساب غير تجريبي. كيفية التعامل مع الجهاز تأكد من أنك تريد الوصول إلى حساب ليس تجريبيًا. إذا كان الأمر كذلك، عليك التقدّم بطلب لترقية الرمز المميّز للمطوِّر إلى إذن بالوصول العادي أو الأساسي. نصائح للوقاية من الفيروس لا ينطبق
DEVELOPER_TOKEN_PROHIBITED	ملخّص غير مسموح بالرمز المميز للمطوِّر مع المشروع المُرسَل في الطلب. الأسباب الشائعة يمكن ربط كل مشروع على Google API Console بالرمز المميز للمطوِّر من حساب إداري واحد فقط. بعد تقديم طلب Google Ads API، يتم إقران الرمز المميّز للمطوِّر بصفة دائمة بمشروع وحدة تحكُّم Google API. في حال عدم استخدام مشروع جديد على Google API Console، ستظهر لك رسالة خطأ DEVELOPER_TOKEN_PROHIBITED عند تقديم طلب. كيفية التعامل مع الجهاز لا ينطبق نصائح للوقاية من الفيروس في حال التبديل إلى الرمز المميز للمطوِّر ضمن حساب إداري جديد، ستحتاج إلى إنشاء مشروع جديد على وحدة تحكُّم Google API لطلبات Google Ads API التي تستخدم الرمز المميز للمدير الجديد.
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	ملخّص تتم إضافة حملة أو إعادة تسميتها، ولكن هذا الاسم قيد الاستخدام حاليًا بواسطة حملة أخرى. الأسباب الشائعة إنشاء حملة جديدة باسم حملة حالية نشطة أو متوقفة مؤقتًا كيفية التعامل مع الجهاز سجِّل الخطأ واعرض رسالة خطأ للمستخدم، مع اقتراح اسم فريد للحملة أو عرض قائمة الأسماء المستخدَمة اختياريًا. نصائح للوقاية من الفيروس لا ينطبق

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