أداة التحقّق من صحة طلبات البحث في "إعلانات Google"

أداة التحقّق من صحة طلبات البحث في "إعلانات Google" هي أداة تفاعلية مصمّمة لمساعدة المطوّرين في إنشاء طلبات بحث بلغة طلبات البحث في "إعلانات Google" (GAQL) والتحقّق من صحتها قبل دمجها في التطبيقات. يتيح لك إدخال سلسلة طلب بحث GAQL وتلقّي ملاحظات فورية بشأن صحتها، ما يساعد في رصد أخطاء البنية وعدم توافق الحقول والمشاكل الأخرى في مرحلة مبكرة من عملية التطوير.

المزايا

  • منع الأخطاء: رصد طلبات البحث غير الصالحة في وقت مبكر، قبل دمجها في التطبيقات، ما يقلّل من أخطاء وقت التشغيل وحالات الإخفاق في طلبات البيانات من واجهة برمجة التطبيقات
  • تطوير أسرع: يتيح الاختبار السريع وتصحيح أخطاء عبارات GAQL بدون الحاجة إلى دورات كاملة لطلبات بيانات من واجهة برمجة التطبيقات وردودها.
  • فهم قيود GAQL: يساعد المطوّرين في التعرّف على القواعد المعقّدة بشأن الحقول المتوافقة وكيفية ارتباط الموارد ببعضها البعض.
  • تصحيح أخطاء طلبات البحث: تقدّم هذه الميزة رسائل خطأ محدّدة عندما يكون طلب البحث غير صالح، وغالبًا ما تكون هذه الرسائل أكثر تفصيلاً من رسالة الخطأ العامة في واجهة برمجة التطبيقات، كما تقترح أحيانًا بدائل صالحة.
  • كفاءة الموارد: تجنُّب طلبات البيانات غير الضرورية من واجهة برمجة التطبيقات باستخدام طلبات بحث من المفترض أن يتعذّر تنفيذها

آلية العمل

يحلّل "مدقّق صحة طلب البحث" طلب بحث GAQL وفقًا لمخطط Google Ads API والقواعد المحدّدة في "لغة طلب البحث في إعلانات Google". تستخدم هذه الأداة بيانات وصفية، يمكن الوصول إلى معظمها من GoogleAdsFieldService، لإجراء عمليات التحقّق، بما في ذلك:

  1. البنية والتصميم: يضمنان أنّ طلب البحث يتّبع قواعد GAQL الصحيحة، بما في ذلك الاستخدام والترتيب المناسبان للعبارات مثل SELECT وFROM وWHERE وORDER BY وLIMIT.
  2. صلاحية الحقل: يتحقّق مما إذا كانت جميع الحقول المحدّدة (المراجع والأقسام والمقاييس) متوفّرة ومكتوبة بشكل صحيح.
  3. توافق الموارد: يتحقّق هذا الخيار من أنّ الحقول المحدّدة في عبارة SELECT متوافقة مع المورد الأساسي المحدّد في عبارة FROM.
  4. توافق الشرائح والمقاييس: يضمن هذا القسم أنّ الشرائح والمقاييس المستخدَمة معًا في طلب البحث نفسه متوافقة مع بعضها البعض ومع المورد في عبارة FROM.
  5. متطلبات العبارة: تتحقّق من صحة القواعد، مثل شرط توفّر حقول معيّنة مستخدَمة في عبارتَي WHERE أو ORDER BY في عبارة SELECT أيضًا.
  6. استخدام عامل التشغيل: يتم التحقّق من الاستخدام الصحيح لعوامل التشغيل ضمن شروط عبارة WHERE.

إذا كان طلب البحث صالحًا، ستؤكّد الأداة ذلك. في حال العثور على مشاكل، تقدّم هذه الأداة رسائل خطأ مصمّمة للمساعدة في تحديد المشكلة، وتقدّم أحيانًا اقتراحات لحلّها، مثل الموارد المتوافقة مع مقياس معيّن.

البدء

لاستخدام "أداة التحقّق من صحة طلبات البحث في إعلانات Google"، اتّبِع الخطوات التالية:

  1. انتقِل إلى أداة التحقّق من صحة طلب البحث.
  2. أدخِل طلب بحث GAQL.
  3. انقر على الزر التحقّق من صحة طلب البحث.
  4. راجِع رسالة التحقّق التي تظهر أسفل التطبيق المصغّر "أداة التحقّق من صحة طلب البحث". تشير رسالة النجاح إلى أنّ طلب البحث صالح. وإلا، سيتم عرض رسالة خطأ تصف المشكلة. توجّهك رسائل الخطأ إلى تصحيح طلب البحث. على سبيل المثال، قد يعرض خطأ عدم توافق أحد الحقول موارد بديلة متوافقة مع المقياس أو الشريحة التي تحاول الاستعلام عنها.

للحصول على شروحات أكثر تفصيلاً حول مفاهيم GAQL وعملية التحقّق من الصحة، يمكنك أيضًا الرجوع إلى أدلة الفيديو حول GAQL.