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

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

google.auth.exceptions.RefreshError

invalid_grant

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