تسرد هذه الصفحة الأخطاء الشائعة وتقدم نصائح حول منعها ومعالجتها.
للحصول على قائمة كاملة بالأخطاء، يمكنك مراجعة مراجع الأخطاء. وللحصول على المزيد من الدعم، يُرجى الانتقال إلى
المنتدى الخاص بنا.
google.auth.exceptions.RefreshError
|
invalid_grant |
ملخّص | انتهت صلاحية الرمز المميّز أو تم إبطاله. |
الأسباب الشائعة |
بالنسبة إلى مشروع Google Cloud Platform الذي يتضمّن شاشة موافقة OAuth تم ضبطها لنوع مستخدم خارجي وحالة نشر Testing ، يتم إصدار رمز مميّز لإعادة تحميل تنتهي صلاحيته خلال 7 أيام.
|
كيفية التعامل |
حالة نشر مشروعك على Google هي "Testing "، لذلك تنتهي صلاحية الرمز المميّز لإعادة التحميل كل 7 أيام مع ظهور خطأ invalid_grant . انتقِل إلى وحدة التحكم في واجهة Google API، ثم إلى شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth. بعد ذلك، عليك تغيير حالة النشر إلى In production باتّباع هذه التعليمات لتجنُّب انتهاء صلاحية الرمز المميّز لإعادة التحميل في 7 أيام.
|
نصائح للوقاية من الفيروس |
راجِع التطبيقات التي لم يتم التحقّق منها.
|
|
|
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR |
ملخّص | لا يمكن استخدام عامل التشغيل هذا مع فئة فرعية من الإعلان. |
الأسباب الشائعة |
محاولة تعديل سمات أخرى غير status للإعلان
|
كيفية التعامل |
لا ينطبق
|
نصائح للوقاية من الفيروس |
لا يمكن تعديل الإعلان بعد إنشاؤه. وإذا أردت تعديل الإعلان، عليك إنشاء إعلان جديد ثم إزالة الإعلان القديم. في المقابل، يمكن تعديل status للإعلان باستخدام MutateAdGroupAds.
|
|
INVALID_INPUT |
ملخّص | يحتوي أحد الحقول في الإعلان على أحرف غير صالحة. |
الأسباب الشائعة |
استخدام رموز خاصة في عناوين URL.
|
كيفية التعامل |
لا ينطبق
|
نصائح للوقاية من الفيروس |
عليك التحقّق من صحة عناوين URL في تطبيقك قبل إرسال طلب البيانات من واجهة برمجة التطبيقات.
|
|
LINE_TOO_WIDE |
ملخّص | كان أحد الحقول في الإعلان أطول من الحد الأقصى المسموح به للطول. اطّلِع على مقالة لمحة عن الإعلانات النصية. |
الأسباب الشائعة |
النص طويل جدًا
|
كيفية التعامل |
لا ينطبق
|
نصائح للوقاية من الفيروس |
ويُرجى التحقّق من صحة طول السطر قبل تقديم طلب البيانات من واجهة برمجة التطبيقات.
|
|
|
AD_GROUP_AD_LABEL_ALREADY_EXISTS |
ملخّص | هذا التصنيف مقترن سلفًا ببعض الإعلانات. |
الأسباب الشائعة |
جارٍ محاولة ربط التصنيف بإعلانات تم ربطها من قبل.
|
كيفية التعامل |
لا ينطبق
|
نصائح للوقاية من الفيروس |
تحقَّق أولاً مما إذا كان التصنيف المطلوب إضافته مرتبطًا بالإعلانات.
|
|
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD |
ملخّص | حاولت عملية تعديل إعلان تمت إزالته. |
الأسباب الشائعة |
بعد إزالة الإعلان، لا يمكن تعديله بعد ذلك، بما في ذلك التغييرات في حالته.
|
كيفية التعامل |
لا ينطبق
|
نصائح للوقاية من الفيروس |
تأكّد من عدم محاولة الرمز تعديل الإعلانات التي تمت إزالتها.
|
|
|
INVALID_KEYWORD_TEXT |
ملخّص | يحتوي نص الكلمة الرئيسية على أحرف غير صالحة. راجِع إضافة كلمات رئيسية. |
الأسباب الشائعة |
يحتوي نص الكلمة الرئيسية على أحرف غير صالحة.
|
كيفية التعامل |
لا ينطبق
|
نصائح للوقاية من الفيروس |
تحقَّق من صحة نص الكلمة الرئيسية في تطبيقك قبل إرسال طلب إلى واجهة برمجة التطبيقات.
|
|
|
DUPLICATE_ADGROUP_NAME |
ملخّص | تتم إضافة مجموعة إعلانية أو إعادة تسميتها، ولكن هناك مجموعة إعلانية أخرى تستخدم هذا الاسم حاليًا. |
الأسباب الشائعة |
إنشاء مجموعة إعلانية جديدة باسم مجموعة إعلانية حالية نشطة أو متوقفة مؤقتًا.
|
كيفية التعامل |
سجِّل الخطأ وقدِّم رسالة الخطأ للمستخدم، ويمكنك بشكل اختياري اقتراح اسم فريد للمجموعة الإعلانية أو عرض قائمة الأسماء المستخدَمة.
|
نصائح للوقاية من الفيروس |
لا ينطبق
|
|
|
DUPLICATE_ASSET |
ملخّص | تشتمل عمليتان في طلب واحد على عملية إنشاء لمادة عرض بنفس البيانات الثنائية. |
الأسباب الشائعة |
طلب تبديل له عمليات إنشاء مكررة تحتوي على البيانات الثنائية نفسها.
|
كيفية التعامل |
أنشئ مادة العرض في طلب منفصل، ثم اربطها بها في الطلب اللاحق، أو استخدِم معرّفًا مؤقتًا في الطلب نفسه.
|
نصائح للوقاية من الفيروس |
لا ينطبق
|
|
|
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.
|
|
|
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 على أنّه رقم تعريف الحساب الإداري بدون واصلات (- ). وقد تم توفير ذلك في مكتبات العملاء.
|
|
|
BID_TOO_MANY_FRACTIONAL_DIGITS |
ملخّص | قيمة عرض السعر ليست مضاعفًا للحد الأدنى لوحدة عملة الحساب. على سبيل المثال، 0.015 دولار أمريكي (15000 بالمايكرو) ليس عرض أسعار صالحًا. |
الأسباب الشائعة |
لا ينطبق
|
كيفية التعامل |
لا ينطبق
|
نصائح للوقاية من الفيروس |
تحقق من أن عروض الأسعار هي مضاعفات للحد الأدنى للوحدة بعملة الحساب.
|
|
BID_TOO_BIG |
|
|
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC |
ملخّص | مبلغ الميزانية صغير جدًا. |
الأسباب الشائعة |
لا ينطبق
|
كيفية التعامل |
لا ينطبق
|
نصائح للوقاية من الفيروس |
تحقَّق من أنّ مبلغ الميزانية أكبر من أو يساوي الحد الأدنى لوحدة عملة الحساب.
|
|
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT |
ملخّص | سيظهر في مبلغ الميزانية عدد كبير جدًا من المنازل العشرية عند تحويله من مبلغ صغير إلى مبلغ بعملة الحساب. |
الأسباب الشائعة |
لا ينطبق
|
كيفية التعامل |
لا ينطبق
|
نصائح للوقاية من الفيروس |
تحقَّق من أنّ مبلغ الميزانية هذا قابل للقسمة على أدنى وحدة بعملة الحساب.
|
|
|
DUPLICATE_CAMPAIGN_NAME |
ملخّص | تتم إضافة حملة أو إعادة تسميتها، ولكن هناك حملة أخرى تستخدم هذا الاسم حاليًا. |
الأسباب الشائعة |
إنشاء حملة جديدة باسم حملة حالية نشطة أو متوقفة مؤقتًا.
|
كيفية التعامل |
سجِّل الخطأ وقدِّم رسالة خطأ للمستخدم، ويمكنك اختياريًا اقتراح اسم حملة فريد أو عرض قائمة الأسماء المستخدَمة.
|
نصائح للوقاية من الفيروس |
لا ينطبق
|
|
|
KEYWORD_HAS_INVALID_CHARS |
ملخّص | إضافة كلمات رئيسية تحتوي على أحرف غير صالحة أو تعديلها. |
الأسباب الشائعة |
استخدم رموزًا خاصة مثل ! @ % * في الكلمات الرئيسية.
|
كيفية التعامل |
لا ينطبق
|
نصائح للوقاية من الفيروس |
تأكد من عدم استخدام أي أحرف غير مسموح بها في الكلمات الرئيسية. راجِع إضافة كلمات رئيسية.
|
|
|
DUPLICATE_ELEMENT |
ملخّص | يحتوي الطلب على معاملين متطابقتين ومكررتين. |
الأسباب الشائعة |
لا ينطبق
|
كيفية التعامل |
لا ينطبق
|
نصائح للوقاية من الفيروس |
إزالة التكرارات (العمليات والمعلمات وعناصر القائمة) قبل إجراء الطلب. ابحث عن الحقول التي تتضمّن القيد DistinctElements .
|
|
|
DEADLINE_EXCEEDED |
ملخّص | انتهت مهلة الطلب وتعذّر إكماله بسرعة كافية لعرض رد. |
الأسباب الشائعة |
تم إجراء طلب بحث أدى إلى إنشاء رد كبير جدًا، أو كان طلب التغيير كبيرًا جدًا بحيث لا يمكن معالجته.
|
كيفية التعامل |
انتظِر لمدة 30 ثانية تقريبًا، ثم أعِد محاولة إجراء الطلب. في حال استمرار ظهور الخطأ، حاوِل تقسيم الطلب إلى عدة طلبات أصغر يمكن إكمالها بسرعة أكبر.
|
نصائح للوقاية من الفيروس |
راجع التصنيف إلى شرائح لفهم كيفية تأثيره في حجم الرد. ويجب الانتباه إلى قيود طبقة النقل gRPC.
|
|
INTERNAL_ERROR |
ملخّص | حدث خطأ غير متوقع أثناء معالجة الطلب. |
الأسباب الشائعة |
لا تعمل واجهة برمجة التطبيقات بشكل صحيح بسبب حدوث خطأ.
|
كيفية التعامل |
أعِد محاولة تنفيذ أي طلبات فشلت بسبب هذا الخطأ، وذلك باستخدام جدول زمني عكسي للتراجع عن إعادة المحاولة.
|
نصائح للوقاية من الفيروس |
لا ينطبق
|
|
TRANSIENT_ERROR |
ملخّص | حدث خطأ داخلي عابر، ويجب إعادة المحاولة. |
الأسباب الشائعة |
يحدث هذا الخطأ عندما تواجه واجهة برمجة التطبيقات مشكلة مؤقتة داخليًا.
|
كيفية التعامل |
أعِد محاولة تنفيذ أي طلبات فشلت بسبب هذا الخطأ، وذلك باستخدام جدول زمني عكسي للتراجع عن إعادة المحاولة.
|
نصائح للوقاية من الفيروس |
لا ينطبق
|
|
InvalidGrantError
|
invalid_grant (malformed auth code) |
ملخّص | تم تكوين رمز التفويض الذي تم استبداله برموز OAuth المميزة بشكل غير صحيح. |
الأسباب الشائعة |
يحدث ذلك عند محاولة إنشاء رمز مميّز لإعادة التحميل لمستخدم سبق أن تم منحه إذن الوصول إلى التطبيق الذي يقدّم الطلب. على سبيل المثال، يمكن أن يحدث ذلك عند تشغيل مثال إنشاء بيانات اعتماد المستخدم أكثر من مرة لبيانات اعتماد عميل OAuth نفسها والمستخدم الذي يمنح إذنًا.
|
كيفية التعامل |
لإعادة إنشاء رمز مميّز لإعادة التحميل لمجموعة معيّنة من بيانات اعتماد المستخدم وعميل OAuth، عليك إبطال الرمز المميّز الحالي لإعادة التحميل. تجدر الإشارة إلى أنّ إبطال الرمز المميّز يجعله غير قابل للاستخدام بالنسبة إلى Google Ads API ويلغي صلاحية أي رموز دخول تم استخدامها لإنشائها.
|
نصائح للوقاية من الفيروس |
احرص على تخزين الرمز المميّز لإعادة التحميل في مكان آمن لتجنُّب إعادة إنشائه.
|
|
|
RESOURCE_NOT_FOUND |
ملخّص | أشار الطلب إلى مورد يتعذّر العثور عليه. |
الأسباب الشائعة |
حاول الطلب تغيير مورد غير متوفر أو تمت إزالته أو الإشارة إليه بأي شكل آخر. أو اسم المورد المحدد للمورد مكتوب بشكلٍ غير صحيح.
|
كيفية التعامل |
استخدِم طلب بحث لاسترداد اسم المورد لمورد حالي قبل إرسال طلب تغيير. مراجعة أدلة مكتبة العملاء، والتي تتضمن مستندات حول كيفية إنشاء أسماء موارد صالحة في كل لغة متاحة
|
نصائح للوقاية من الفيروس |
لا تنشئ أسماء موارد يدويًا. استخدام إحدى الطرق المساعدة التي تقدّمها مكتبات العملاء
|
|
|
EMPTY_LIST |
ملخّص | القائمة المطلوبة فارغة. |
الأسباب الشائعة |
تمرير قائمة فارغة من العمليات إلى طريقة mutate
|
كيفية التعامل |
لا ينطبق
|
نصائح للوقاية من الفيروس |
لا ينطبق
|
|
|
RESOURCE_EXHAUSTED |
ملخّص | تم تجاوز الحد الأقصى لمعدّل تكرار النظام. |
الأسباب الشائعة |
لا ينطبق
|
كيفية التعامل |
لا ينطبق
|
نصائح للوقاية من الفيروس |
تحديد مهلة قصيرة بين الطلبات أو دمج المزيد من العمليات في عدد أقل من الطلبات
|
|
|
TOO_LOW |
ملخّص | كانت إحدى القيم أقل من الحدّ الأدنى المسموح به. |
الأسباب الشائعة |
في حال نسيان تحديد رقم تعريف، يتم تمرير قيمة 0 .
|
كيفية التعامل |
لا ينطبق
|
نصائح للوقاية من الفيروس |
لاحِظ أي قيود موثَّقة في مرجع واجهة برمجة التطبيقات.
|
|
|
INVALID_INPUT |
ملخّص | صياغة الطلب غير صحيحة. |
الأسباب الشائعة |
عنوان URL أو محتوى الطلب مكتوب بشكلٍ غير صحيح.
|
كيفية التعامل |
لا ينطبق
|
نصائح للوقاية من الفيروس |
لا ينطبق
|
|
REQUIRED_FIELD_MISSING |
ملخّص | لا يتضمّن الطلب بعض المعلومات المطلوبة. |
الأسباب الشائعة |
يُرجى ملء الحقول المطلوبة عند محاولة إضافة عنصر.
|
كيفية التعامل |
سجِّل الخطأ وقدِّم رسالة الخطأ للمستخدم. تشير السمة fieldPath للخطأ إلى الحقل غير المتوفّر.
|
نصائح للوقاية من الفيروس |
يُرجى الرجوع إلى مرجع واجهة برمجة التطبيقات لمعرفة الحقول المطلوبة.
|
|
|
RESOURCE_LIMIT |
ملخّص | يحاول الطلب إنشاء مورد سيؤدي إلى تجاوز إجمالي عدد هذه الموارد حدًّا محددًا. |
الأسباب الشائعة |
هناك حدود متعددة لعدد الموارد التي يمكن أن توجد في سياقات معينة.
|
كيفية التعامل |
حدِّد الحد الذي تواجهه من خلال مراجعة حدود النظام. يمكنك إما إعادة استخدام مورد موجود أو إزالة بعض الموارد لتوفير مساحة لمورد جديد.
|
نصائح للوقاية من الفيروس |
استخدم طلبات البحث لمراقبة عدد الموارد التي تفرض قيودًا.
|
|
|
TOO_LONG |
ملخّص | السلسلة المخصّصة للحقل المحدّد أطول من الحدّ الأقصى. |
الأسباب الشائعة |
تحتوي العناوين أو أوصاف الإعلانات على نصوص كثيرة جدًا.
|
كيفية التعامل |
حدِّد الحدّ الأقصى الذي يتم رصده، وعدِّل السلسلة وفقًا لذلك، وأعِد إرسال الطلب.
|
نصائح للوقاية من الفيروس |
انتبِه إلى حدود طول السلسلة.
|
|