تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تسرد هذه الصفحة الأخطاء الشائعة وتقدّم نصائح حول كيفية تجنّبها والتعامل معها.
للحصول على قائمة كاملة بالأخطاء، راجِع مراجع
الخطأ. للحصول على مزيد من الدعم، يُرجى الانتقال إلى
المنتدى.
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" وانتقِل إلى شاشة طلب الموافقة على بروتوكول OAuth. بعد ذلك، غيِّر حالة النشر إلى In production باتّباع هذه التعليمات لتجنُّب انتهاء صلاحية الرمز المميّز لإعادة التحميل بعد 7 أيام.
يجب أن يكون الرقم 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 غير صحيح.
كيفية التعامل مع
لا ينطبق
نصائح للوقاية من الفيروس
تأكَّد من إرسال رمز الوصول الصحيح المرتبط بحسابك. ويتم الخلط بينه أحيانًا ورموز إعادة التحميل ورموز التفويض. إذا كنت تريد الحصول على بيانات اعتماد يمكنها الوصول إلى جميع حسابات العملاء ضمن حساب إداري، تأكَّد من الحصول على الرمز المميّز لإعادة التحميل للحساب الإداري. لمزيد من التفاصيل، يُرجى الاطّلاع على دليلنا حول رمز الوصول ورمز إعادة التحميل وOAuth2.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN
ملخّص
سبق أن تم ربط الرمز المميّز للمطوّر بمؤسسة في Google Cloud ولا يمكن ربطه بمؤسسة أخرى.
الأسباب الشائعة
رمز مطوّر البرامج غير مرتبط بمشروع على Google Cloud في مؤسسة Google Cloud نفسها التي ينتمي إليها مشروع Google Cloud المستخدَم لتقديم الطلبات في الأصل.
كيفية التعامل مع
تأكَّد من أنّ معرِّف عميل OAuth مرتبط بمشاريع Google Cloud في مؤسسة Google Cloud نفسها إذا سبق لك تقديم طلبات بيانات من واجهة برمجة التطبيقات باستخدام الرمز المميّز للمطوِّر.
نصائح للوقاية من الفيروس
تأكَّد من ربط جميع مشاريعك على Google Cloud بمؤسسة Google Cloud نفسها. يمكن ربط مشروع على Google Cloud برمز مميّز للمطوّر واحد فقط، ولكن يمكن ربط رمز مميّز للمطوّر بمشاريع متعددة في المؤسسة.
DEVELOPER_TOKEN_INVALID
ملخّص
الرمز المميّز للمطوّر غير صالح.
الأسباب الشائعة
تشمل الأسباب الشائعة لهذا الخطأ الأخطاء الإملائية في الرمز المميّز للمطوّر أو ضبط الرمز المميّز للمطوّر بشكل غير صحيح في عنوان طلب مختلف.
كيفية التعامل مع
احرص على نسخ الرمز المميّز للمطوّر من مركز واجهة برمجة التطبيقات لتجنُّب الأخطاء الإملائية. يمكنك العثور على مركز واجهة برمجة التطبيقات في حسابك الإداري على "إعلانات Google". تأكَّد أيضًا من ضبط رمز مطوّر البرامج في العنوان الصحيح. يتم أحيانًا الخلط بين رموز المطوّرين ورموز إعادة تحميل OAuth ورموز التفويض. يمكنك الاطّلاع على مزيد من المعلومات حول رؤوس الطلبات المختلفة هنا.
لا يمكن الوصول إلى حساب العميل لأنّه ليس في حالة مفعّلة.
الأسباب الشائعة
يحدث ذلك عندما لا يكون حساب العميل قد اكتمل تسجيله أو تم إيقافه.
كيفية التعامل مع
سجِّل الدخول إلى واجهة مستخدم "إعلانات Google" وتأكَّد من إكمال عملية الاشتراك لهذا الحساب. بالنسبة إلى الحسابات غير مفعّلة، يُرجى الاطّلاع على إعادة تفعيل حساب مُلغى على "إعلانات Google".
نصائح للوقاية من الفيروس
يمكنك التحقّق بشكل استباقي مما إذا تم إيقاف حساب عميل من خلال البحث عن حالة مُلغى.
DEVELOPER_TOKEN_NOT_APPROVED
ملخّص
تمّت الموافقة على استخدام الرمز المميّز للمطوّر مع الحسابات التجريبية فقط، ولكن تمّت محاولة الوصول إلى حساب غير تجريبي.
الأسباب الشائعة
تم استخدام رمز مميّز للمطوّر في وضع الاختبار للوصول إلى حساب غير اختباري.
الرمز المميّز للمطوّر غير مسموح به مع المشروع الذي تم إرساله في الطلب.
الأسباب الشائعة
يمكن ربط كل مشروع في Google API Console برمز المطوِّر من حساب إداري واحد فقط. بعد إرسال طلب إلى Google Ads API، يتم إقران الرمز المميّز للمطوّر بشكل دائم بمشروع Google API Console. إذا لم تستخدم مشروعًا جديدًا في "وحدة تحكّم واجهة برمجة تطبيقات Google"، سيظهر لك خطأ DEVELOPER_TOKEN_PROHIBITED عند تقديم طلب.
كيفية التعامل مع
لا ينطبق
نصائح للوقاية من الفيروس
في حال التبديل إلى رمز مميّز للمطوّر ضمن حساب إداري جديد، عليك إنشاء مشروع جديد في Google API Console لطلبات Google Ads API التي تستخدِم الرمز المميّز للحساب الإداري الجديد.
USER_PERMISSION_DENIED
ملخّص
لا يملك العميل المفوَّض إذن الوصول إلى العميل المشغِّل.
الأسباب الشائعة
المصادقة كمستخدم لديه إذن الوصول إلى حساب إداري ولكن بدون تحديد login-customer-id في الطلب
كيفية التعامل مع
لا ينطبق
نصائح للوقاية من الفيروس
حدِّد login-customer-id كرقم تعريف الحساب الإداري بدون واصلة (-). تتضمّن مكتبات العملاء دعمًا مضمّنًا لهذا الإجراء.
تاريخ التعديل الأخير: 2025-06-18 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-06-18 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This page provides solutions and preventative measures for common Google Ads API errors."],["For a comprehensive list of errors, refer to the dedicated error references section."],["Additional assistance and community support can be found on the Google Ads API forum."],["Understanding and addressing these errors is crucial for successful API integration and campaign management."]]],[]]
