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

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

google.auth.exceptions.RefreshError

invalid_grant
ملخّصانتهت صلاحية الرمز المميّز أو تم إبطاله.
الأسباب الشائعة بالنسبة إلى مشروع Google Cloud Platform الذي يتضمّن شاشة طلب موافقة OAuth تم ضبطها لنوع مستخدم خارجي وحالة نشر Testing، يتم إصدار رمز مميّز لإعادة التحميل تنتهي صلاحيته خلال 7 أيام.
كيفية التعامل مع الجهاز حالة النشر لمشروعك على 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. في حال عدم استخدام مشروع جديد على Google API Console، ستظهر لك رسالة خطأ DEVELOPER_TOKEN_PROHIBITED عند تقديم طلب.
كيفية التعامل مع الجهاز لا ينطبق
نصائح للوقاية من الفيروس في حال التبديل إلى الرمز المميز للمطوِّر ضمن حساب إداري جديد، ستحتاج إلى إنشاء مشروع جديد على وحدة تحكُّم Google API لطلبات Google Ads API التي تستخدم الرمز المميز للمدير الجديد.
USER_PERMISSION_DENIED
ملخّصلا يمكن للعميل المفوّض الوصول إلى عميل التشغيل.
الأسباب الشائعة المصادقة كمستخدم لديه إذن الوصول إلى حساب إداري ولكن بدون تحديد login-customer-id في الطلب
كيفية التعامل مع الجهاز لا ينطبق
نصائح للوقاية من الفيروس حدِّد login-customer-id كرقم تعريف الحساب الإداري بدون واصلات (-). توفّر مكتبات العملاء إمكانية إجراء ذلك.