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

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

google.auth.exceptions.RefreshError

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

AuthorizationError

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