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

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

google.auth.exceptions.RefreshError

invalid_grant
ملخّصانتهت صلاحية الرمز المميّز أو تم إبطاله.
الأسباب الشائعة يتم إصدار رمز مميز لإعادة التحميل ينتهي صلاحيته بعد 7 أيام لمشروع على Google Cloud Platform تم ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth فيه لنوع مستخدم خارجي وحالة النشر Testing.
كيفية التعامل مع حالة نشر مشروعك على Google هي Testing، لذا تنتهي صلاحية الرمز المميّز لإعادة التحميل كل 7 أيام ويتلقّى خطأ invalid_grant. انتقِل إلى "وحدة تحكّم واجهة برمجة تطبيقات Google" وانتقِل إلى شاشة طلب الموافقة على بروتوكول 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 غير صحيح.
كيفية التعامل مع لا ينطبق
نصائح للوقاية من الفيروس تأكَّد من إرسال رمز الوصول الصحيح المرتبط بحسابك. ويُخلط أحيانًا بينه وبين رموز إعادة التحميل ورموز التفويض. إذا كنت تريد الحصول على بيانات اعتماد يمكنها الوصول إلى جميع حسابات العملاء ضمن حساب إداري، تأكَّد من الحصول على الرمز المميّز لإعادة التحميل للحساب الإداري. لمزيد من التفاصيل، يُرجى الاطّلاع على دليلنا حول رمز الوصول ورمز إعادة التنشيط وOAuth2.

AuthorizationError

CUSTOMER_NOT_ENABLED
ملخّصلا يمكن الوصول إلى حساب العميل لأنّه ليس في حالة مفعّلة.
الأسباب الشائعة يحدث ذلك عندما لا يكون حساب العميل قد اكتمل تسجيله أو تم إيقافه.
كيفية التعامل مع سجِّل الدخول إلى واجهة مستخدم "إعلانات Google" وتأكَّد من إكمال عملية الاشتراك لهذا الحساب. بالنسبة إلى الحسابات غير النشطة، اطّلِع على إعادة تفعيل حساب مُلغى على "إعلانات Google".
نصائح للوقاية من الفيروس يمكنك التحقّق بشكل استباقي مما إذا تم إيقاف حساب عميل من خلال البحث عن حالة مُلغى.
DEVELOPER_TOKEN_NOT_APPROVED
ملخّصتمّت الموافقة على استخدام الرمز المميّز للمطوّر مع الحسابات التجريبية فقط، ولكن تمّت محاولة الوصول إلى حساب غير تجريبي.
الأسباب الشائعة تم استخدام رمز مميّز للمطوّر التجريبي للوصول إلى حساب غير تجريبي.
كيفية التعامل مع تأكَّد من أنّك تريد الوصول إلى حساب غير اختباري. إذا كان الأمر كذلك، عليك تقديم طلب لترقية الرمز المميّز للمطوّر إلى إذن الوصول العادي أو الأساسي.
نصائح للوقاية من الفيروس لا ينطبق
DEVELOPER_TOKEN_PROHIBITED
ملخّصالرمز المميّز للمطوّر غير مسموح به مع المشروع الذي تم إرساله في الطلب.
الأسباب الشائعة يمكن ربط كل مشروع في Google API Console برمز المطوِّر من حساب إداري واحد فقط. بعد إرسال طلب إلى Google Ads API، يتم إقران الرمز المميّز للمطوّر بشكل دائم بمشروع Google API Console. إذا لم تستخدم مشروعًا جديدًا في "وحدة تحكّم واجهة برمجة تطبيقات Google"، سيظهر لك خطأ DEVELOPER_TOKEN_PROHIBITED عند تقديم طلب.
كيفية التعامل مع لا ينطبق
نصائح للوقاية من الفيروس في حال التبديل إلى رمز مميّز للمطوّر ضمن حساب إداري جديد، عليك إنشاء مشروع جديد في Google API Console لطلبات Google Ads API التي تستخدِم الرمز المميّز للحساب الإداري الجديد.
USER_PERMISSION_DENIED
ملخّصلا يملك العميل المفوَّض إذن الوصول إلى العميل المشغِّل.
الأسباب الشائعة المصادقة بصفتك مستخدمًا لديه إذن الوصول إلى حساب إداري ولكن بدون تحديد login-customer-id في الطلب
كيفية التعامل مع لا ينطبق
نصائح للوقاية من الفيروس حدِّد login-customer-id كرقم تعريف الحساب الإداري بدون واصلة (-). تتضمّن مكتبات العملاء دعمًا مضمّنًا لهذا الإجراء.