تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تسرد هذه الصفحة الأخطاء الشائعة وتقدّم نصائح حول كيفية تجنُّبها والتعامل معها.
للحصول على قائمة كاملة بالأخطاء، راجِع مراجع الأخطاء. للحصول على مزيد من الدعم، يُرجى الانتقال إلى
المنتدى.
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 أيام.
يجب أن يكون الرقم 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.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN
ملخّص
الرمز المميّز للمطوّر مرتبط حاليًا بمؤسسة Google Cloud ولا يمكن ربطه بمؤسسة أخرى.
الأسباب الشائعة
لا يرتبط رمز المطوّر بمشروع على Google Cloud في مؤسسة Google Cloud نفسها التي تم استخدامها في الأصل لتقديم الطلبات.
كيفية التعامل معها
تأكَّد من أنّ معرّف عميل OAuth مرتبط بمشاريع Google Cloud في مؤسسة Google Cloud نفسها إذا سبق لك إرسال طلبات بيانات من واجهة برمجة التطبيقات باستخدام الرمز المميز للمطوِّر.
نصائح للوقاية من الفيروس
احرص على ربط جميع مشاريعك على Google Cloud بمؤسسة Google Cloud نفسها. يمكن ربط مشروع Google Cloud برمز مميّز واحد فقط للمطوّر، ولكن يمكن ربط رمز مميّز للمطوّر بمشاريع متعددة في المؤسسة.
DEVELOPER_TOKEN_INVALID
ملخّص
رمز المطوِّر غير صالح.
الأسباب الشائعة
تشمل الأسباب الشائعة لهذا الخطأ أخطاء إملائية في الرمز المميز للمطوّر أو ضبط الرمز المميز للمطوّر بشكل غير صحيح في عنوان طلب مختلف.
كيفية التعامل معها
احرص على نسخ الرمز المميز للمطوّر من "مركز واجهة برمجة التطبيقات" لتجنُّب الأخطاء الإملائية. يمكنك العثور على "مركز واجهات برمجة التطبيقات" في حسابك الإداري على "إعلانات Google". يُرجى أيضًا التأكّد من ضبط رمز المطوّر المميز في العنوان الصحيح. يحدث أحيانًا خلط بين الرموز المميزة للمطوّرين ورموز إعادة تحميل OAuth المميزة ورموز التفويض. يمكنك الاطّلاع على مزيد من المعلومات حول عناوين الطلبات المختلفة هنا.
لا يمكن الوصول إلى حساب العميل لأنّه ليس في حالة مفعّلة.
الأسباب الشائعة
يحدث ذلك عندما لم يكمل العميل عملية الاشتراك في الحساب أو تم إيقافه.
كيفية التعامل معها
سجِّل الدخول إلى واجهة مستخدم "إعلانات Google" وتأكَّد من إكمال عملية الاشتراك لهذا الحساب. بالنسبة إلى الحسابات غير النشطة، اطّلِع على مقالة إعادة تفعيل حساب مُلغى على "إعلانات Google".
نصائح للوقاية من الفيروس
يمكنك التحقّق بشكل استباقي مما إذا كان حساب العميل غير مفعّل من خلال البحث عن الحالة ملغى.
DEVELOPER_TOKEN_NOT_APPROVED
ملخّص
تمت الموافقة على استخدام الرمز المميز للمطوّر مع الحسابات الاختبارية فقط، وتمت محاولة الوصول إلى حساب غير اختباري.
الأسباب الشائعة
تم استخدام رمز مميّز للمطوّرين خاص بالاختبار للوصول إلى حساب غير مخصّص للاختبار.
لا يُسمح باستخدام الرمز المميز للمطوّر مع المشروع المُرسَل في الطلب.
الأسباب الشائعة
يمكن ربط كل مشروع في Google API Console بالرمز المميز للمطوِّر من حساب إداري واحد فقط. بعد إرسال طلب إلى Google Ads API، يتم ربط الرمز المميز للمطوِّر بشكل دائم بمشروع Google API Console. إذا لم تستخدِم مشروعًا جديدًا في Google API Console، سيظهر لك الخطأ DEVELOPER_TOKEN_PROHIBITED عند إرسال طلب.
كيفية التعامل معها
لا ينطبق
نصائح للوقاية من الفيروس
في حال التبديل إلى رمز مميز للمطوِّر ضمن حساب إداري جديد، عليك إنشاء مشروع جديد في Google API Console لطلبات Google Ads API التي تستخدم الرمز المميز للحساب الإداري الجديد.
USER_PERMISSION_DENIED
ملخّص
لا يملك العميل المفوَّض إذن الوصول إلى العميل المشغِّل.
الأسباب الشائعة
المصادقة كمستخدم لديه إذن الوصول إلى حساب إداري ولكن بدون تحديد login-customer-id في الطلب
كيفية التعامل معها
لا ينطبق
نصائح للوقاية من الفيروس
حدِّد login-customer-id كمعرّف الحساب الإداري بدون واصلات (-). تتضمّن مكتبات البرامج دعمًا مدمجًا لذلك.
تاريخ التعديل الأخير: 2025-07-13 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2025-07-13 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This page provides solutions and preventative measures for common Google Ads API errors."],["For a comprehensive list of errors, refer to the dedicated error references section."],["Additional assistance and community support can be found on the Google Ads API forum."],["Understanding and addressing these errors is crucial for successful API integration and campaign management."]]],[]]
