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

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

المزايا

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

طريقة العمل

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

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

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

البدء

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

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

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