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

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

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 وانتقِل إلى شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth. بعد ذلك، غيِّر حالة النشر إلى In production لتجنُّب انتهاء صلاحية الرمز المميز لإعادة التحميل بعد 7 أيام.
نصائح للوقاية من الفيروس يمكنك الاطّلاع على التطبيقات التي لم يتم التحقّق منها.

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID
ملخّصمعرّف العميل ليس رقمًا.
الأسباب الشائعة استخدام معرّف عميل غير مناسب
كيفية التعامل مع الخطأ لا ينطبق
نصائح للوقاية من الفيروس يجب أن يكون 123-456-7890 هو 1234567890. يمكنك الاطّلاع على مقالة البدء للحصول على التفاصيل.
CLIENT_CUSTOMER_ID_IS_REQUIRED
ملخّصلم يتم تحديد معرّف العميل في عنوان HTTP.
الأسباب الشائعة عدم تحديد معرّف العميل في عنوان HTTP
كيفية التعامل مع الخطأ لا ينطبق
نصائح للوقاية من الفيروس معرّف العميل مطلوب لجميع الطلبات، لذا تأكَّد من تحديد معرّف في عنوان HTTP. ننصحك باستخدام مكتبات العملاء لأنّها تتعامل مع هذه الحالة نيابةً عنك.
CUSTOMER_NOT_FOUND
ملخّصلم يتم العثور على حساب لمعرّف العميل المقدَّم في العنوان.
الأسباب الشائعة محاولة الوصول إلى حساب تم إنشاؤه للتو قبل إنشاء الحساب في النظام الخلفي
كيفية التعامل مع الخطأ انتظِر خمس دقائق أولاً، ثم أعِد المحاولة كل 30 ثانية.
نصائح للوقاية من الفيروس انتظِر بضع دقائق بعد إنشاء الحساب قبل إرسال طلبات إليه.
ملخّصرمز الدخول في عنوان الطلب غير صالح أو انتهت صلاحيته.
الأسباب الشائعة تم إبطال رمز الدخول.
كيفية التعامل مع الخطأ اطلب رمزًا جديدًا. إذا كنت تستخدم إحدى مكتبات العملاء، يُرجى الرجوع إلى مستنداتها لمعرفة كيفية إعادة تحميل الرمز.
نصائح للوقاية من الفيروس يمكنك تخزين رموز الدخول وإعادة استخدامها إلى أن تنتهي صلاحيتها.
NOT_ADS_USER
ملخّصحساب Google المستخدَم لإنشاء رمز الدخول غير مرتبط بأي حساب على "إعلانات Google".
الأسباب الشائعة تتطابق معلومات تسجيل الدخول المقدَّمة مع حساب Google غير مفعَّل فيه "إعلانات Google".
كيفية التعامل مع الخطأ احرص على تسجيل الدخول باستخدام حساب صالح على "إعلانات Google" (عادةً ما يكون حسابك الإداري) لتدفق OAuth. يمكنك أيضًا دعوة حساب Google للوصول إلى حساب حالي على "إعلانات Google" من خلال تسجيل الدخول إلى حسابك الإداري، واختيار حساب العميل أو الحساب الإداري المعني، والانتقال إلى Tools and Settings > Access and security، ثم إضافة عنوان البريد الإلكتروني لحساب Google.
نصائح للوقاية من الفيروس لا ينطبق
OAUTH_TOKEN_INVALID
ملخّصرمز الدخول عبر OAuth في العنوان غير صالح.
الأسباب الشائعة لم يكن رمز الدخول الذي تم تمريره مع عنوان HTTP صحيحًا.
كيفية التعامل مع الخطأ لا ينطبق
نصائح للوقاية من الفيروس تأكَّد من أنّك مرّرت رمز الدخول الصحيح المرتبط بحسابك. يتم أحيانًا الخلط بينه وبين رموز إعادة التحميل ورموز التفويض. إذا كنت تريد الحصول على بيانات اعتماد يمكنها الوصول إلى جميع حسابات العملاء ضمن حساب إداري، تأكَّد من الحصول على الرمز المميز لإعادة التحميل للحساب الإداري. يمكنك الاطّلاع على دليل مصادقة المستخدم .
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN
ملخّصالرمز المميّز للمطوّر مرتبط حاليًا بمؤسسة على Google Cloud ولا يمكن ربطه بمؤسسة أخرى.
الأسباب الشائعة الرمز المميز للمطوِّر غير مرتبط بمشروع على السحابة الإلكترونية على Google Cloud في مؤسسة Google Cloud نفسها التي يتضمّنها مشروع على السحابة الإلكترونية على Google Cloud المستخدَم في الأصل لإرسال الطلبات.
كيفية التعامل مع الخطأ تأكَّد من أنّ معرّف عميل OAuth مرتبط بمشاريع على Google Cloud في مؤسسة Google Cloud نفسها إذا سبق لك إرسال طلبات إلى واجهة برمجة التطبيقات باستخدام الرمز المميّز للمطوّر.
نصائح للوقاية من الفيروس تأكَّد من ربط جميع مشاريعك على Google Cloud بمؤسسة Google Cloud نفسها. لا يمكن ربط مشروع على Google Cloud إلا برمز مميّز واحد للمطوّر، ولكن يمكن ربط رمز مميّز للمطوّر بمشاريع متعددة في المؤسسة.
DEVELOPER_TOKEN_INVALID
ملخّصالرمز المميّز للمطوّر غير صالح.
الأسباب الشائعة تتضمّن الأسباب الشائعة لهذا الخطأ الأخطاء الإملائية في الرمز المميّز للمطوّر، أو ضبط الرمز المميّز للمطوّر بشكلٍ غير صحيح في عنوان طلب مختلف.
كيفية التعامل مع الخطأ تأكَّد من نسخ الرمز المميّز للمطوّر من مركز واجهة برمجة التطبيقات لتجنُّب الأخطاء الإملائية. يمكنك العثور على مركز واجهة برمجة التطبيقات في حسابك الإداري على "إعلانات Google". تأكَّد أيضًا من ضبط الرمز المميّز للمطوّر في العنوان الصحيح. يتم أحيانًا الخلط بين الرموز المميّزة للمطوّر ورموز إعادة التحميل ورموز التفويض عبر OAuth. يمكنك قراءة المزيد عن عناوين الطلبات المختلفة هنا.
نصائح للوقاية من الفيروس لا ينطبق

AuthorizationError
CUSTOMER_NOT_ENABLED
ملخّصلا يمكن الوصول إلى حساب العميل لأنّه ليس في حالة مفعّلة.
الأسباب الشائعة يحدث ذلك عندما لم يكتمل اشتراك حساب العميل أو تم إيقافه.
كيفية التعامل مع الخطأ سجِّل الدخول إلى واجهة مستخدم "إعلانات Google" وتأكَّد من إكمال عملية الاشتراك في هذا الحساب. بالنسبة إلى الحسابات التي تم إيقافها، يمكنك الاطّلاع على مقالة إعادة تفعيل حساب مُلغى على "إعلانات Google".
نصائح للوقاية من الفيروس يمكنك التحقّق بشكلٍ استباقي مما إذا كان حساب العميل غير مفعّل من خلال البحث عن الحالة CANCELLED.
DEVELOPER_TOKEN_NOT_APPROVED
ملخّصتمت الموافقة على الرمز المميّز للمطوّر لاستخدامه مع الحسابات التجريبية فقط، وتمت محاولة الوصول إلى حساب غير تجريبي.
الأسباب الشائعة تم استخدام الرمز المميز للمطوِّر التجريبي للوصول إلى حساب غير تجريبي.
كيفية التعامل مع الخطأ تأكَّد من أنّك تريد فعلاً الوصول إلى حساب غير تجريبي. إذا كان الأمر كذلك، عليك تقديم طلب لترقية الرمز المميّز للمطوّر إلى مستوى الوصول العادي أو الأساسي.
نصائح للوقاية من الفيروس لا ينطبق
DEVELOPER_TOKEN_PROHIBITED
ملخّصلا يُسمح باستخدام الرمز المميّز للمطوّر مع المشروع الذي تم إرساله في الطلب.
الأسباب الشائعة يمكن ربط كل مشروع على 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 كمعرّف الحساب الإداري بدون واصلات (-). تتضمّن مكتبات العملاء دعمًا مضمّنًا لهذه الميزة.

السابق
معالجة الأخطاء
التالي
الخطوات التالية