تم رفض الطلب لأنّ رمز الدخول المقدَّم لا يتضمّن نطاق 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 أيام.
لا يمكن استخدام عامل التشغيل هذا مع فئة فرعية من Ad.
الأسباب الشائعة
محاولة تعديل سمات أخرى غير status للإعلان
طريقة التعامل
لا ينطبق
نصائح للوقاية من الفيروس
بعد إنشاء الإعلان، لا يمكن تعديله. إذا أردت تعديل الإعلان، عليك إنشاء إعلان جديد ثم إزالة الإعلان القديم. ومع ذلك، يمكن تعديل status الإعلان باستخدام MutateAdGroupAds.
INVALID_INPUT
ملخّص
يحتوي أحد الحقول في الإعلان على أحرف غير صالحة.
الأسباب الشائعة
استخدام أحرف خاصة في عناوين URL
طريقة التعامل
لا ينطبق
نصائح للوقاية من الفيروس
تحقَّق من صحة عناوين URL في تطبيقك قبل إرسال طلب البيانات من واجهة برمجة التطبيقات.
يجب أن يكون الرقم 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 غير صحيح.
طريقة التعامل
لا ينطبق
نصائح للوقاية من الفيروس
تأكَّد من تمرير رمز الدخول الصحيح المرتبط بحسابك. ويتم أحيانًا الخلط بينه وبين الرموز المميزة لإعادة التحميل ورموز التفويض. إذا أردت الحصول على بيانات اعتماد يمكنها الوصول إلى جميع حسابات العملاء ضمن حساب مدير، تأكَّد من الحصول على الرمز المميز لإعادة التحميل لحساب المدير. يُرجى الاطّلاع على دليل مصادقة المستخدم.
يملك مشروع Google Cloud إذن وصول تجريبي فقط ولا يمكن استخدامه للوصول إلى حسابات الإنتاج.
الأسباب الشائعة
تم استخدام مشروع على السحابة الإلكترونية من Google Cloud مع مستوى الوصول التجريبي لتقديم طلب إلى حساب "إعلانات Google" غير تجريبي (إنتاج). (في الإصدارات v24 والإصدارات الأقدم من واجهة برمجة التطبيقات، يعرض هذا الشرط القيمة AuthorizationError.ACTION_NOT_PERMITTED).
لا يمكن الوصول إلى حساب العميل لأنّه ليس في حالة مفعَّلة.
الأسباب الشائعة
يحدث ذلك عندما لا يكون حساب العميل قد أكمل عملية الاشتراك أو تم إيقافه.
طريقة التعامل
سجِّل الدخول إلى واجهة مستخدم "إعلانات Google" وتأكَّد من إكمال عملية الاشتراك لهذا الحساب. بالنسبة إلى الحسابات التي تم إيقافها، يُرجى الاطّلاع على مقالة إعادة تفعيل حساب مُلغى على "إعلانات Google".
نصائح للوقاية من الفيروس
يمكنك التحقّق بشكل استباقي مما إذا تم إيقاف حساب عميل من خلال البحث عن الحالة CANCELLED.
USER_PERMISSION_DENIED
ملخّص
لا يملك العميل المفوَّض إذن الوصول إلى العميل المشغِّل.
الأسباب الشائعة
المصادقة كمستخدم لديه إذن الوصول إلى حساب إداري ولكن بدون تحديد login-customer-id في الطلب
طريقة التعامل
لا ينطبق
نصائح للوقاية من الفيروس
حدِّد login-customer-id كرقم تعريف الحساب الإداري بدون واصلات (-). تتضمّن مكتبات العملاء دعمًا مدمجًا لذلك.
تتم إضافة حملة أو إعادة تسميتها، ولكن الاسم مستخدَم حاليًا في حملة أخرى.
الأسباب الشائعة
إنشاء حملة جديدة باسم حملة حالية نشطة أو متوقفة مؤقتًا
طريقة التعامل
سجِّل الخطأ واعرِض رسالة خطأ للمستخدم، واقترِح اختياريًا اسم حملة فريدًا أو اعرِض قائمة الأسماء المستخدَمة.
نصائح للوقاية من الفيروس
لا ينطبق
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`.
لا يمكن تفعيل "حملة زيادة طلب" تم نقلها قبل إزالة الحملة الأصلية، أو عندما تكون هناك حملة أخرى تم نقلها للحملة الأصلية نفسها نشطة حاليًا.
الأسباب الشائعة
تعديل status "حملة زيادة الطلب" التي تم نقلها إلى ENABLED في حال عدم إزالة الحملة المصدر الأصلية أو في حال كانت "حملة زيادة الطلب" الأخرى التي تم نقلها من الحملة الأصلية نفسها قد تم ENABLED. في الإصدارات v25 من واجهة برمجة التطبيقات والإصدارات الأقدم، يعرض هذا الشرط RequestError.UNKNOWN.
طريقة التعامل
أزِل الحملة المصدر الأصلية باستخدام CampaignOperation.remove (إما مسبقًا أو في طلب التغيير نفسه) قبل تفعيل "حملة زيادة الطلب" التي تم نقلها، وتأكَّد من عدم تفعيل أي "حملة زيادة طلب" أخرى تم نقلها من الحملة الأصلية نفسها. يُرجى الاطّلاع على مقالة تفعيل الحملات التي تم نقلها لمزيد من التفاصيل.
نصائح للوقاية من الفيروس
إذا كنت تتتبّع أرقام تعريف حملاتك المصدر الأصلية و"حملات زيادة الطلب" التي تم نقلها، يمكنك الاستعلام عن campaign.status قبل ضبط status على ENABLED في حملة تم نقلها، أو تضمين CampaignOperation.remove للحملة الأصلية في طلب التغيير نفسه.
أعِد محاولة إرسال أي طلبات تعذّر تنفيذها بسبب هذا الخطأ، باستخدام جدول زمني لخوارزمية الرقود الأسي الثنائي لإعادة المحاولة.
نصائح للوقاية من الفيروس
لا ينطبق
TRANSIENT_ERROR
ملخّص
حدث خطأ داخلي عابر، ويجب إعادة المحاولة.
الأسباب الشائعة
يحدث هذا الخطأ عندما تواجه واجهة برمجة التطبيقات مشكلة مؤقتة داخليًا.
طريقة التعامل
أعِد محاولة إرسال أي طلبات تعذّر تنفيذها بسبب هذا الخطأ، باستخدام جدول زمني لخوارزمية الرقود الأسي الثنائي لإعادة المحاولة.
نصائح للوقاية من الفيروس
لا ينطبق
InvalidGrantError
invalid_grant (malformed auth code)
ملخّص
كان رمز التفويض الذي تم تبادله برموز OAuth المميّزة غير صالح.
الأسباب الشائعة
يحدث ذلك عند محاولة إنشاء رمز مميز لإعادة التحميل لمستخدم سبق أن تم منحه إذن الوصول إلى التطبيق الذي يطلب ذلك. على سبيل المثال، يمكن أن يحدث ذلك عند تشغيل مثال إنشاء بيانات اعتماد المستخدم أكثر من مرة لبيانات اعتماد عميل OAuth نفسها والمستخدم المفوَّض.
طريقة التعامل
لإعادة إنشاء رمز مميّز لإعادة التحميل لمجموعة معيّنة من بيانات اعتماد المستخدم المفوِّض وعميل OAuth، عليك إبطال رمز مميّز حالي لإعادة التحميل. يُرجى العِلم أنّ إبطال رمز مميّز يجعله غير صالح للاستخدام للوصول إلى Google Ads API، كما يؤدي إلى إبطال أي رموز مميّزة للوصول تم استخدام الرمز المميّز لإعادة التحميل لإنشائها.
نصائح للوقاية من الفيروس
احرص على تخزين الرمز المميز لإعادة التحميل في مكان آمن لتجنُّب الحاجة إلى إعادة إنشائه.
حاول الطلب تغيير مورد غير موجود أو تمت إزالته أو الإشارة إليه بطريقة أخرى. أو أنّ اسم المورد المحدّد غير صالح.
طريقة التعامل
استخدِم طلب بحث لاسترداد اسم مورد حالي قبل إرسال طلب تغيير. راجِع أدلة مكتبة برامج العميل التي تتضمّن مستندات حول كيفية إنشاء أسماء موارد صالحة بكل لغة متاحة
نصائح للوقاية من الفيروس
لا تنشئ أسماء الموارد يدويًا. استخدِم إحدى الطرق المساعدة التي توفّرها مكتبات العملاء.
تاريخ التعديل الأخير: 2026-10-28 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2026-10-28 (حسب التوقيت العالمي المتفَّق عليه)"],[],[]]