تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تسرد هذه الصفحة الأخطاء الشائعة وتقدّم نصائح حول كيفية تجنّبها والتعامل معها. للحصول على قائمة كاملة بالأخطاء، راجِع مراجع الخطأ. للحصول على مزيد من الدعم، يُرجى الانتقال إلى المنتدى.
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 أيام.
لا يمكن استخدام عامل التشغيل هذا مع فئة فرعية من Ad.
الأسباب الشائعة
محاولة تعديل سمات غير status للإعلان
كيفية التعامل مع
لا ينطبق
نصائح للوقاية من الفيروس
بعد إنشاء إعلان، لا يمكن تعديله. إذا أردت تعديل الإعلان، عليك إنشاء إعلان جديد ثم إزالة الإعلان القديم. ومع ذلك، يمكن تعديل status الإعلان باستخدام MutateAdGroupAds.
INVALID_INPUT
ملخّص
يحتوي أحد الحقول في أحد الإعلانات على أحرف غير صالحة.
الأسباب الشائعة
استخدام أحرف خاصة في عناوين URL
كيفية التعامل مع
لا ينطبق
نصائح للوقاية من الفيروس
تحقَّق من صحة عناوين URL في تطبيقك قبل إرسال طلب واجهة برمجة التطبيقات.
LINE_TOO_WIDE
ملخّص
كان أحد الحقول في أحد الإعلانات أطول من الحد الأقصى المسموح به. اطّلِع على لمحة عن الإعلانات النصية.
الأسباب الشائعة
إذا كان سطر النص طويلًا جدًا
كيفية التعامل مع
لا ينطبق
نصائح للوقاية من الفيروس
تحقّق من طول السطر قبل إرسال طلب واجهة برمجة التطبيقات.
يجب أن يكون الرقم 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 برمز مميّز للمطوّر واحد فقط، ولكن يمكن ربط رمز مميّز للمطوّر بمشاريع متعدّدة في المؤسسة.
لا يمكن الوصول إلى حساب العميل لأنّه ليس في حالة مفعّلة.
الأسباب الشائعة
يحدث ذلك عندما لا يكون حساب العميل قد أكمل عملية الاشتراك أو تم إيقافه.
كيفية التعامل مع
سجِّل الدخول إلى واجهة مستخدم "إعلانات 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 كرقم تعريف الحساب الإداري بدون واصلة (-). تتضمّن مكتبات العملاء دعمًا مضمّنًا لهذا الإجراء.
أعِد محاولة إرسال أي طلبات تعذّر إرسالها بسبب هذا الخطأ، باستخدام جدول زمني للتراجع الأسي الثنائي لعمليات إعادة المحاولة.
نصائح للوقاية من الفيروس
لا ينطبق
TRANSIENT_ERROR
ملخّص
حدث خطأ داخلي عابر، ويجب إعادة المحاولة.
الأسباب الشائعة
يحدث هذا الخطأ عندما تواجه واجهة برمجة التطبيقات مشكلة مؤقتة داخليًا.
كيفية التعامل مع
أعِد محاولة إرسال أي طلبات تعذّر إرسالها بسبب هذا الخطأ، باستخدام جدول زمني للتراجع الأسي الثنائي لعمليات إعادة المحاولة.
نصائح للوقاية من الفيروس
لا ينطبق
InvalidGrantError
invalid_grant (malformed auth code)
ملخّص
رمز التفويض الذي تم تبديله برموز OAuth المميّزة كان بتنسيق غير صحيح.
الأسباب الشائعة
يحدث ذلك عند محاولة إنشاء رمز مميّز لإعادة التحميل لمستخدم سبق أن تم منحه إذن الوصول إلى التطبيق الذي يطلب الرمز. على سبيل المثال، يمكن أن يحدث ذلك عند تنفيذ مثال إنشاء بيانات اعتماد المستخدم أكثر من مرة لبيانات اعتماد عميل OAuth نفسه والمستخدم المفوَّض.
كيفية التعامل مع
لإعادة إنشاء رمز إعادة التحميل لمزيج معيّن من بيانات اعتماد المستخدم المفوّض وبيانات اعتماد برنامج OAuth، عليك إبطال رمز إعادة التحميل الحالي. يُرجى العلم أنّ إلغاء رمز مميّز يجعله غير قابل للاستخدام للوصول إلى Google Ads API ويبطل أي رموز مميّزة للوصول تم استخدام رمز إعادة التحميل لإنشائها.
نصائح للوقاية من الفيروس
احرص على تخزين الرمز المميّز لإعادة التحميل في مكان آمن لتجنُّب الحاجة إلى إعادة إنشائه.
حاول الطلب تغيير مورد غير متوفّر أو تمت إزالته أو الإشارة إليه. أو أنّ اسم المورد الذي تمّ تحديده للمورد غير صالح.
كيفية التعامل مع
استخدِم طلب بحث لاسترداد اسم مورد حالي قبل إرسال طلب تغيير. راجِع أدلة مكتبة العملاء التي تتضمّن مستندات حول كيفية إنشاء أسماء موارد صالحة بكل لغة متوافقة.
نصائح للوقاية من الفيروس
لا تنشئ أسماء الموارد يدويًا. استخدِم إحدى طرق المساعدة التي تقدّمها مكتبات العملاء.
تاريخ التعديل الأخير: 2025-06-04 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-04 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The Google Ads API returns a variety of errors related to authentication, ads, assets, bidding, and budgets, providing specific error codes for troubleshooting."],["Common causes of errors include invalid inputs, exceeding limits, and resource conflicts, necessitating careful validation of data and adherence to API guidelines."],["Suggested solutions involve correcting inputs, adjusting values to meet requirements, ensuring unique names, and retrying with exponential backoff for transient errors."],["Understanding the error codes and their corresponding descriptions enables developers to effectively diagnose and resolve issues encountered during API interactions."],["Developers should consult the Google Ads API documentation for detailed explanations of each error and recommended best practices to avoid them."]]],[]]