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

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

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

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