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

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

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

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