أداة التحقّق من صحة طلبات البحث في "إعلانات Google" هي أداة تفاعلية مصمّمة لمساعدة المطوّرين في إنشاء طلبات بحث بلغة طلبات البحث في "إعلانات Google" (GAQL) والتحقّق من صحتها قبل دمجها في التطبيقات. يتيح لك إدخال سلسلة طلب بحث GAQL وتلقّي ملاحظات فورية بشأن صحتها، ما يساعد في رصد أخطاء البنية وعدم توافق الحقول والمشاكل الأخرى في مرحلة مبكرة من عملية التطوير.
المزايا
- تجنُّب الأخطاء: رصد طلبات البحث غير الصالحة في وقت مبكر قبل دمجها في التطبيقات، ما يقلّل من أخطاء وقت التشغيل وحالات فشل طلبات البيانات من واجهة برمجة التطبيقات
- تطوير أسرع: يتيح إجراء اختبارات وتصحيح أخطاء سريعَين لعبارات GAQL بدون الحاجة إلى دورات كاملة لطلبات واجهة برمجة التطبيقات واستجاباتها.
- فهم قيود GAQL: يساعد المطوّرين في التعرّف على القواعد المعقّدة بشأن الحقول المتوافقة وكيفية ارتباط الموارد ببعضها البعض.
- تصحيح أخطاء طلبات البحث: تقدّم هذه الميزة رسائل خطأ محدّدة عندما يكون طلب البحث غير صالح، وغالبًا ما تكون هذه الرسائل أكثر تفصيلاً من رسائل الخطأ العامة في واجهة برمجة التطبيقات، كما تقترح أحيانًا بدائل صالحة.
- كفاءة الموارد: تتجنّب هذه الميزة طلبات البيانات غير الضرورية من واجهة برمجة التطبيقات باستخدام طلبات بحث من المفترض أن يتعذّر تنفيذها.
آلية العمل
يحلّل "مدقّق صحة طلب البحث" طلب بحث GAQL وفقًا لمخطط Google Ads API والقواعد المحدّدة في "لغة طلب البحث في إعلانات Google". تستخدم هذه الأداة بيانات وصفية،
يمكن الوصول إلى معظمها من GoogleAdsFieldService، لإجراء عمليات التحقّق،
بما في ذلك:
- البنية والتصميم: يضمنان أنّ طلب البحث يتّبع قواعد GAQL الصحيحة، بما في ذلك الاستخدام والترتيب المناسبان للعبارات مثل
SELECTوFROMوWHEREوORDER BYوLIMIT. - صلاحية الحقل: يتحقّق مما إذا كانت جميع الحقول المحدّدة (المراجع والأقسام والمقاييس) متوفّرة ومكتوبة بشكل صحيح.
- توافق الموارد: يتحقّق هذا الخيار من أنّ الحقول المحدّدة في عبارة
SELECTمتوافقة مع المورد الأساسي المحدّد في عبارةFROM. - توافق الشرائح والمقاييس: يضمن هذا الشرط أنّ الشرائح والمقاييس المستخدَمة معًا في طلب البحث نفسه متوافقة مع بعضها البعض ومع المورد في عبارة
FROM. - متطلبات البند البرمجي: تتحقّق من صحة القواعد، مثل شرط توفّر حقول معيّنة مستخدَمة في بنود برمجية
WHEREأوORDER BYفي بند برمجيSELECTأيضًا. - استخدام عامل التشغيل: يتحقّق من الاستخدام الصحيح لعوامل التشغيل ضمن شروط العبارة
WHERE.
إذا كان طلب البحث صالحًا، ستؤكّد الأداة ذلك. في حال العثور على مشاكل، تقدّم هذه الأداة رسائل خطأ مصمّمة للمساعدة في تحديد المشكلة، وتقدّم أحيانًا اقتراحات لحلّها، مثل المراجع المتوافقة مع مقياس معيّن.
البدء
لاستخدام "أداة التحقّق من صحة طلبات البحث" في "إعلانات Google"، اتّبِع الخطوات التالية:
- انتقِل إلى أداة التحقّق من صحة طلب البحث.
- أدخِل طلب بحث GAQL.
- انقر على الزر التحقّق من صحة طلب البحث.
- راجِع رسالة التحقّق التي تظهر أسفل التطبيق المصغّر "أداة التحقّق من صحة طلب البحث". تشير رسالة النجاح إلى أنّ طلب البحث صالح. وإلا، ستظهر رسالة خطأ تصف المشكلة. توجّهك رسائل الخطأ إلى تصحيح طلب البحث. على سبيل المثال، قد يعرض خطأ عدم توافق أحد الحقول موارد بديلة متوافقة مع المقياس أو الشريحة التي تحاول الاستعلام عنها.
للحصول على شروحات أكثر تفصيلاً حول مفاهيم GAQL وإثبات صحتها، يمكنك أيضًا الرجوع إلى أدلة الفيديو حول GAQL.