اختَر مشروعك. إذا لم يسبق لك إنشاء مشروع، اطّلِع على مقالة
إنشاء مشروع لعميلك.
في الشريط الجانبي على اليمين، وسِّع واجهات برمجة التطبيقات والمصادقة. بعد ذلك،
انقر على واجهات برمجة التطبيقات. في
قائمة واجهات برمجة التطبيقات، تأكّد من أنّ حالة Search Ads 360 API هي مفعّلة.
Invalid grant
يحدث هذا الخطأ عندما لا يكون رمز إعادة التنشيط صالحًا. يمكنك الحصول على رمز إعادة التنشيط
من خلال استدعاء نص إعلانات شبكة البحث 360
البرمجي على النحو التالي:
يحدث هذا الخطأ إذا لم تحدِّد اسم منتج عند إعداد
مشروعك في Google API Console. لحلّ هذا الخطأ،
أدخِل اسم
منتجك في شاشة طلب الموافقة في "وحدة تحكّم واجهة برمجة التطبيقات من Google".
يسرد الجدول التالي الأخطاء التي قد تواجهها عند تحميل الإحالات الناجحة. يُرجى العِلم أنّه
لا يمكن تغيير رموز الخطأ الست عشرية، لذا يمكنك استخدامها في نصوصك البرمجية لتحديد الأخطاء.
رمز الخطأ
الرسالة
الوصف
0x00000101
Click ID '{ID}' is not found
رقم تعريف النقرة الذي حدّدته في طلب
update غير صالح. أعِد تحميل الإحالات الناجحة بعد تنفيذ ما يلي:
التأكّد من أنّه تمّ إنشاء معرّف النقرة قبل 6 ساعات من تحميل الإحالات الناجحة
إذا كنت
تُنسِب الإحالات الناجحة إلى زيارات معيّنة، انتظِر 6 ساعات على الأقل بعد
الزيارة قبل تحميل الإحالة الناجحة. قد لا تتعرّف "إعلانات شبكة البحث 360" على معرّف النقرة للزيارة في حال
تحميله قبل مرور 6 ساعات على الزيارة. في حالات نادرة، قد تحتاج إلى
الانتظار لمدة تصل إلى 24 ساعة قبل أن تتمكّن "إعلانات شبكة البحث 360" من التعرّف على مَعلمة clickId.
تأكَّد من توفّر نشاط Floodlight للمعلِن الذي حدّدته في عمود
advertiserId. (من المحتمل أنّك حدّدت المعلِن غير الصحيح).
بعد إنشاء نشاط Floodlight أو تعديله، انتظِر بضع ساعات قبل تحميل
الإحالات الناجحة للنشاط.
0x00000115
Custom dimension '{name}' is not found
تأكَّد من أنّه تم
إعداد متغيّر Floodlight المخصّص الذي حدّدته كسمة
(وليس مقياسًا) للمعلِن المرتبط بالقيمة
clickId
أو criterionId
أو productGroupId
التي يتم تحديد مصدر الإحالة الناجحة لها.
0x00000116
Custom metric '{name}' is not found
تأكَّد من أنّه تم
إعداد متغيّر Floodlight المخصّص الذي حدّدته كأحد
المقاييس (وليس سمة) للمعلِن المرتبط بالملفّ الشخصي
clickId،
criterionId،
أو productGroupId
الذي يتم تحديد مصدر الإحالة الناجحة له.
0x0000011A
The advertiser conversion ID is already specified for a conversion with Search Ads 360
conversion ID {ID}
سبق أن حمّل مستخدم إحالة ناجحة للنطاق نفسه ورقم تعريف الإحالة الناجحة للمعلِن
نفسه المحدّد في عمود
conversionId.
"رقم تعريف الإحالة الناجحة للمعلِن" هو معرّف تنشئه. تتطلّب "إعلانات شبكة البحث 360" أن يكون هذا المعرّف فريدًا
في نطاق معيّن. تُنشئ "إعلانات شبكة البحث 360"
رقم تعريف الإحالة الناجحة في "إعلانات شبكة البحث 360"، وهو فريد بالتأكيد.
0x0000011B
Advertiser conversion ID '{ID}' is not found
حاول طلبك
update تعديل رقم تعريف إحالة ناجحة للمعلِن غير
موجود. تأكَّد من تحديد رقم التعريف الصحيح.
0x0000011D
User does not have permission to view advertiser {advertiser ID}
لا يملك حساب Google الذي يستخدمه عميلك إذنًا بالاطّلاع على المعلِن
المحدّد في الطلب.
عند تسجيل الدخول إلى "وحدة تحكّم Google API" لاسترداد رقم تعريف العميل وملفه الشخصي العميل
السري، وعند الحصول على رمز مميّز لإعادة التحميل، احرص على استخدام حساب Google
الذي تم منحه إذن الوصول إلى العميل
الذي حدّدته.
0x0000011F
Advertiser conversion ID is already specified in this request
تُحدِّد إشارتان أو أكثر للإحالات الناجحة في الطلب النطاق نفسه و
رقم تعريف الإحالة الناجحة للمعلِن نفسه.
رقم تعريف الإحالة الناجحة للمعلِن هو رقم تعريف تنشئه وتحدّده في عمود
conversionId. تتطلّب "إعلانات شبكة البحث 360" أن يكون هذا المعرّف فريدًا في نطاق معيّن.
0x0000011E
The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)
لا يتطابق رقم تعريف نشاط Floodlight أو اسمه الذي قدّمته مع نوع الإحالة الناجحة الذي حدّدته.
0x00000126
Service internal error
يُرجى إعادة إرسال طلبك بعد بعض الوقت. من المرجّح أن يكون هذا خطأ عابرًا. يُرجى
التواصل مع فريق دعم "إعلانات شبكة البحث 360" في حال استمرار ظهور هذا الخطأ.
تاريخ التعديل الأخير: 2025-04-07 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-04-07 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This page provides troubleshooting information for common issues encountered while using the Search Ads 360 API, including authorization and conversion upload errors."],["If the provided resources don't resolve your issue, contact support with specific information about your problem, including your Search Ads 360 and Google API Console credentials, code snippets, and JSON responses."],["The page lists common authorization errors such as `Access Not Configured`, `Invalid grant`, and `Invalid client`, with explanations and solutions."],["It also includes a table of conversion upload errors, detailing their hexadecimal error codes, descriptions, and troubleshooting steps."],["For report discrepancies, refer to the Response Codes and Standard Error Responses documentation and ensure the `includeRemovedEntities` setting in your request matches the \"Show removed\" checkbox selection in the Search Ads 360 UI."]]],["When troubleshooting the Search Ads 360 API, consult the provided resources. If issues persist, contact support, providing your Agency/Advertiser ID, Project Number, API access username, code snippet, and JSON response (including full error messages). Common authorization errors include `Access Not Configured`, `Invalid grant`, and `Invalid client`, often resolved by enabling the API, refreshing tokens, or naming your project. Conversion upload errors relate to invalid click IDs, Floodlight activity names, or custom dimensions/metrics. Ensure correct permissions and data consistency between UI and API.\n"]]
