تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.
الأخطاء الشائعة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تسرد هذه الصفحة الأخطاء الشائعة وتقدّم نصائح حول كيفية منعها والتعامل معها.
للحصول على قائمة كاملة بالأخطاء، يُرجى مراجعة مرجع الأخطاء أو دليل فهم أخطاء واجهة برمجة التطبيقات أو دليل أنواع الأخطاء. للمزيد من المساعدة، يُرجى التواصل مع
فريق دعم 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 أيام.
|
| نصائح للوقاية من الفيروس |
يُرجى الاطّلاع على التطبيقات التي لم يتم التحقّق منها.
|
|
|
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR |
| ملخّص | لا يمكن استخدام عامل التشغيل هذا مع فئة فرعية من Ad. |
| الأسباب الشائعة |
محاولة تعديل سمات أخرى غير 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 |
| ملخّص | تحتوي عمليتان في طلب واحد على عملية إنشاء مادة عرض تتضمّن البيانات الثنائية نفسها. |
| الأسباب الشائعة |
طلب تغيير يتضمّن عمليات إنشاء مكرّرة تحتوي على البيانات الثنائية نفسها.
|
| طريقة التعامل |
أنشِئ مادة العرض في طلب منفصل، ثم اربطها بالطلب اللاحق، أو استخدِم معرّفًا مؤقتًا ضمن الطلب نفسه.
|
| نصائح للوقاية من الفيروس |
لا ينطبق
|
|
PARTNER_PROMOTION_ID_TYPE_INCOMPATIBLE |
| ملخّص | يستخدم معرّف العرض الترويجي للشريك صيغة oneof (int_value أو string_value) لا يقبلها دمج العروض الترويجية في الحساب. |
| الأسباب الشائعة |
ضبط الحقل promotion_asset.external_redeem_info.partner_promotion_id.int_value عندما يتطلّب دمج عملية التحصيل لدى العميل استخدام الصيغة string_value، أو ضبط الحقل string_value عندما يتطلّب الدمج استخدام الصيغة int_value.
|
| طريقة التعامل |
عدِّل طلب الإنشاء لملء صيغة ExternalPartnerId (int_value أو string_value) التي يقبلها دمج العروض الترويجية في الحساب. يمكنك الاطّلاع على مقالة تتبُّع عمليات تحصيل قيمة العروض الترويجية الخارجية لمعرفة التفاصيل.
|
| نصائح للوقاية من الفيروس |
تأكَّد من تنسيق معرّف العرض الترويجي (int_value أو string_value) الذي تستخدمه عملية دمج الاستفادة من العروض في نقطة البيع (POS) قبل إنشاء رسالة PromotionAsset تتضمّن الحقل external_redeem_info.
|
|
|
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 غير صحيح.
|
| طريقة التعامل |
لا ينطبق
|
| نصائح للوقاية من الفيروس |
تأكَّد من تمرير رمز الدخول الصحيح المرتبط بحسابك. ويتم أحيانًا الخلط بينه وبين الرموز المميزة لإعادة التحميل ورموز التفويض. إذا أردت الحصول على بيانات اعتماد يمكنها الوصول إلى جميع حسابات العملاء ضمن حساب مدير، تأكَّد من الحصول على الرمز المميز لإعادة التحميل لحساب المدير. يُرجى الاطّلاع على دليل مصادقة المستخدم.
|
|
|
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION |
| ملخّص | يملك مشروع Google Cloud إذن وصول تجريبي فقط ولا يمكن استخدامه للوصول إلى حسابات الإنتاج. |
| الأسباب الشائعة |
تم استخدام مشروع على السحابة الإلكترونية من Google Cloud مع مستوى الوصول التجريبي لتقديم طلب إلى حساب "إعلانات Google" غير تجريبي (إنتاج). (في الإصدارات v24 والإصدارات الأقدم من واجهة برمجة التطبيقات، يعرض هذا الشرط القيمة 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 كرقم تعريف الحساب الإداري بدون واصلات (-). تتضمّن مكتبات العملاء دعمًا مدمجًا لذلك.
|
|
|
BID_TOO_MANY_FRACTIONAL_DIGITS |
| ملخّص | قيمة عرض السعر ليست من مضاعفات الحد الأدنى لوحدة عملة الحساب. على سبيل المثال، لا يُعدّ عرض السعر 0.015 دولار أمريكي (15000 بالوحدات الصغرى) صالحًا. |
| الأسباب الشائعة |
لا ينطبق
|
| طريقة التعامل |
لا ينطبق
|
| نصائح للوقاية من الفيروس |
تأكَّد من أنّ عروض الأسعار هي من مضاعفات الحدّ الأدنى للوحدة لعملة الحساب.
|
|
BID_TOO_BIG |
| ملخّص | يتم عرض الخطأ على الرغم من أنّ عرض السعر يقع ضمن ميزانية الحملة. |
| الأسباب الشائعة |
لا ينطبق
|
| طريقة التعامل |
لا ينطبق
|
| نصائح للوقاية من الفيروس |
تحقَّق مما إذا كان الحساب مشاركًا في برنامج منحة إعلانية من Google. إذا كان الأمر كذلك، يمكنك حصر عروض أسعار النقرة على الحدّ الأقصى الذي يحدّده البرنامج.
|
|
|
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC |
| ملخّص | مبلغ الميزانية صغير جدًا. |
| الأسباب الشائعة |
لا ينطبق
|
| طريقة التعامل |
لا ينطبق
|
| نصائح للوقاية من الفيروس |
يُرجى التأكّد من أنّ مبلغ الميزانية أكبر من أو يساوي الحدّ الأدنى للوحدة لعملة الحساب.
|
|
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT |
| ملخّص | سيحتوي مبلغ الميزانية على عدد كبير جدًا من المنازل العشرية المهمة عند تحويله من مبلغ صغير إلى مبلغ بعملة الحساب. |
| الأسباب الشائعة |
لا ينطبق
|
| طريقة التعامل |
لا ينطبق
|
| نصائح للوقاية من الفيروس |
يُرجى التأكّد من أنّ مبلغ الميزانية يقبل القسمة على الحدّ الأدنى للوحدة لعملة الحساب.
|
|
|
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`.
|
|
|
KEYWORD_HAS_INVALID_CHARS |
| ملخّص | إضافة كلمات رئيسية تحتوي على أحرف غير صالحة أو تعديلها |
| الأسباب الشائعة |
استخدام رموز خاصة مثل ! @ % * في الكلمات الرئيسية
|
| طريقة التعامل |
لا ينطبق
|
| نصائح للوقاية من الفيروس |
تأكَّد من عدم استخدام أي أحرف غير مسموح بها في الكلمات الرئيسية. يُرجى الاطّلاع على إضافة كلمات رئيسية.
|
|
|
CANNOT_ACTIVATE_MIGRATED_CAMPAIGN |
| ملخّص | لا يمكن تفعيل "حملة زيادة طلب" تم نقلها قبل إزالة الحملة الأصلية، أو عندما تكون هناك حملة أخرى تم نقلها للحملة الأصلية نفسها نشطة حاليًا. |
| الأسباب الشائعة |
تعديل status "حملة زيادة الطلب" التي تم نقلها إلى ENABLED في حال عدم إزالة الحملة المصدر الأصلية أو في حال كانت "حملة زيادة الطلب" الأخرى التي تم نقلها من الحملة الأصلية نفسها قد تم ENABLED. في الإصدارات v25 من واجهة برمجة التطبيقات والإصدارات الأقدم، يعرض هذا الشرط RequestError.UNKNOWN.
|
| طريقة التعامل |
أزِل الحملة المصدر الأصلية باستخدام CampaignOperation.remove (إما مسبقًا أو في طلب التغيير نفسه) قبل تفعيل "حملة زيادة الطلب" التي تم نقلها، وتأكَّد من عدم تفعيل أي "حملة زيادة طلب" أخرى تم نقلها من الحملة الأصلية نفسها. يُرجى الاطّلاع على مقالة تفعيل الحملات التي تم نقلها لمزيد من التفاصيل.
|
| نصائح للوقاية من الفيروس |
إذا كنت تتتبّع أرقام تعريف حملاتك المصدر الأصلية و"حملات زيادة الطلب" التي تم نقلها، يمكنك الاستعلام عن campaign.status قبل ضبط status على ENABLED في حملة تم نقلها، أو تضمين CampaignOperation.remove للحملة الأصلية في طلب التغيير نفسه.
|
|
|
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 |
| ملخّص | السلسلة المخصّصة للحقل المحدّد أطول من الحدّ المسموح به. |
| الأسباب الشائعة |
تحتوي عناوين الإعلانات أو أوصافها على نص طويل جدًا.
|
| طريقة التعامل |
حدِّد الحدّ الذي تم تجاوزه، وعدِّل السلسلة وفقًا لذلك، ثم أعِد إرسال الطلب.
|
| نصائح للوقاية من الفيروس |
يُرجى الانتباه إلى حدود طول السلسلة.
|
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2026-10-30 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2026-10-30 (حسب التوقيت العالمي المتفَّق عليه)"],[],[]]