أداة التحقّق من صحة طلبات البحث في "إعلانات 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.