اعتبارسنج پرسوجوی گوگل ادز ابزاری تعاملی است که برای کمک به توسعهدهندگان در ساخت و تأیید پرسوجوهای زبان پرسوجوی گوگل ادز (GAQL) قبل از ادغام آنها در برنامهها طراحی شده است. این ابزار به شما امکان میدهد یک رشته پرسوجوی GAQL را وارد کنید و بلافاصله در مورد اعتبار آن بازخورد دریافت کنید و به شما در تشخیص خطاهای نحوی، ناسازگاری فیلدها و سایر مشکلات در اوایل فرآیند توسعه کمک میکند.
مزایا
- پیشگیری از خطا: کوئریهای نامعتبر را قبل از اینکه در برنامهها ادغام شوند، شناسایی میکند و خطاهای زمان اجرا و عدم موفقیت در فراخوانی API را کاهش میدهد.
- توسعه سریعتر: امکان تست و اشکالزدایی سریع دستورات GAQL را بدون سربار چرخههای کامل درخواست و پاسخ API فراهم میکند.
- درک محدودیتهای GAQL: به توسعهدهندگان کمک میکند تا قوانین پیچیده در مورد اینکه کدام فیلدها سازگار هستند و نحوه ارتباط منابع با یکدیگر را بیاموزند.
- اشکالزدایی کوئریها: وقتی یک کوئری نامعتبر است، پیامهای خطای خاصی ارائه میدهد که اغلب جزئیات بیشتری نسبت به یک خطای عمومی API دارند و گاهی اوقات جایگزینهای معتبری را پیشنهاد میدهد.
- بهرهوری منابع: از فراخوانیهای غیرضروری API با کوئریهایی که محکوم به شکست هستند، جلوگیری میکند.
چگونه کار میکند؟
اعتبارسنج پرسوجو، پرسوجوی GAQL شما را با طرحواره API گوگل ادز و قوانین تعریفشده در زبان پرسوجوی گوگل ادز تجزیه و تحلیل میکند. این ابزار از فرادادهها، که بخش عمدهای از آنها از GoogleAdsFieldService قابل دسترسی است، برای انجام بررسیها، از جمله موارد زیر، استفاده میکند:
- نحو و ساختار: تضمین میکند که پرسوجو از دستور زبان صحیح GAQL، از جمله استفاده صحیح و ترتیب عباراتی مانند
SELECT،FROM،WHERE،ORDER BYوLIMITپیروی میکند. - اعتبار فیلد: بررسی میکند که آیا همه فیلدهای مشخص شده (منابع، بخشها، معیارها) وجود دارند و به درستی نوشته شدهاند یا خیر.
- سازگاری منابع: تأیید میکند که فیلدهای انتخاب شده در عبارت
SELECTبا منبع اصلی مشخص شده در عبارتFROMسازگار هستند. - سازگاری بخشبندی و معیارها: تضمین میکند که بخشبندیها و معیارهای استفادهشده در یک پرسوجو با یکدیگر و با منبع موجود در عبارت
FROMسازگار باشند. - الزامات بند: قوانینی مانند الزام فیلدهای خاصی که در بندهای
WHEREیاORDER BYاستفاده میشوند را برای حضور در بندSELECTنیز اعتبارسنجی میکند. - استفاده از عملگرها: بررسی میکند که آیا عملگرها در شرایط عبارت
WHEREبه درستی استفاده شدهاند یا خیر.
اگر پرسوجو معتبر باشد، این ابزار آن را تأیید میکند. در صورت وجود مشکل، پیامهای خطایی را ارائه میدهد که برای کمک به شناسایی دقیق مشکل طراحی شدهاند و گاهی اوقات پیشنهادهایی برای رفع مشکل، مانند منابع سازگار با یک معیار مشخص، ارائه میدهند.
شروع کنید
برای استفاده از اعتبارسنج پرسوجوی گوگل ادز:
- به اعتبارسنج پرسوجو (Query Validator) بروید.
- عبارت جستجوی GAQL خود را وارد کنید.
- روی دکمه اعتبارسنجی استعلام کلیک کنید.
- پیام اعتبارسنجی که در زیر ویجت اعتبارسنجی پرسوجو ظاهر میشود را بررسی کنید. یک پیام موفقیتآمیز نشان میدهد که پرسوجو معتبر است. در غیر این صورت، یک پیام خطا که مشکل را شرح میدهد نمایش داده میشود. پیامهای خطا شما را برای اصلاح پرسوجو راهنمایی میکنند. به عنوان مثال، یک خطای ناسازگاری فیلد ممکن است منابع جایگزینی را فهرست کند که *با معیار یا بخشی که میخواهید پرسوجو کنید* سازگار هستند.
برای توضیحات عمیقتر در مورد مفاهیم و اعتبارسنجی GAQL، میتوانید به راهنماهای ویدیویی GAQL نیز مراجعه کنید.