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

يسرد هذا الدليل أخطاء واجهة برمجة التطبيقات الشائعة ويقدّم استراتيجيات لمنعها والتعامل معها.

للاطّلاع على قائمة شاملة بجميع أنواع الأخطاء، يُرجى الرجوع إلى مرجع أخطاء Google Ads API. إذا كنت بحاجة إلى مساعدة إضافية، اطرح سؤالاً في منتدى Google Ads API.

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 أيام. نصائح للوقاية من الفيروس يمكنك الاطّلاع على التطبيقات التي لم يتم التحقّق منها.

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	ملخّص رقم تعريف العميل ليس رقمًا. الأسباب الشائعة استخدام رقم تعريف عميل غير مناسب طريقة التعامل لا ينطبق نصائح للوقاية من الفيروس يجب أن يكون الرقم 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 صحيحًا. طريقة التعامل لا ينطبق نصائح للوقاية من الفيروس تأكَّد من أنّك مرّرت رمز الدخول الصحيح المرتبط بحسابك. يتم الخلط أحيانًا بينه وبين الرموز المميزة لإعادة التحميل ورموز التفويض. إذا كنت تريد الحصول على بيانات اعتماد يمكنها الوصول إلى جميع حسابات العملاء ضمن حساب إداري، تأكَّد من الحصول على الرمز المميز لإعادة التحميل للحساب الإداري. يمكنك الاطّلاع على دليل مصادقة المستخدم .

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