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

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

google.auth.exceptions.RefreshError

invalid_grant

ملخّص انتهت صلاحية الرمز المميّز أو تم إبطاله. الأسباب الشائعة يتم إصدار رمز مميز لإعادة التحميل ينتهي صلاحيته بعد 7 أيام لمشروع على Google Cloud Platform تم ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth فيه لنوع مستخدم خارجي وحالة النشر Testing. كيفية التعامل مع حالة نشر مشروعك على Google هي Testing، لذا تنتهي صلاحية الرمز المميّز لإعادة التحميل كل 7 أيام ويتلقّى خطأ invalid_grant. انتقِل إلى "وحدة تحكّم واجهة برمجة تطبيقات Google" وانتقِل إلى شاشة طلب الموافقة على بروتوكول 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 غير صحيح. كيفية التعامل مع لا ينطبق نصائح للوقاية من الفيروس تأكَّد من إرسال رمز الوصول الصحيح المرتبط بحسابك. ويتم الخلط بينه أحيانًا ورموز إعادة التحميل ورموز التفويض. إذا كنت تريد الحصول على بيانات اعتماد يمكنها الوصول إلى جميع حسابات العملاء ضمن حساب إداري، تأكَّد من الحصول على الرمز المميّز لإعادة التحميل للحساب الإداري. لمزيد من التفاصيل، يُرجى الاطّلاع على دليلنا حول رمز الوصول ورمز إعادة التنشيط وOAuth2.

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