«اعتبارسنج پُرسمان Google Ads» ابزاری تعاملی است که برای کمک به توسعه‌دهندگان در ساختن و درستی‌سنجی پُرسمان‌های «زبان پُرسمان Google Ads» (GAQL) قبل‌از ادغام آن‌ها در برنامه‌ها طراحی شده است. این ابزار به شما امکان می‌دهد رشته پُرسمان GAQL را وارد کنید و بازخورد فوری درباره اعتبار آن دریافت کنید، که به شناسایی خطاهای نحوی، ناسازگاری‌های فیلد، و سایر مشکلات در مراحل اولیه فرایند توسعه کمک می‌کند.
مزايا
- جلوگیری از خطا: پرسمان‌های نامعتبر را پیش‌از ادغام شدن در برنامه‌ها شناسایی می‌کند و خطاهای زمان اجرا و ناموفق شدن فراخوانی‌های میانای برنامه‌سازی کاربردی را کاهش می‌دهد.
- توسعه سریع‌تر: امکان آزمایش و اشکال‌زدایی سریع عبارت‌های GAQL را بدون سربار چرخه‌های کامل درخواست و پاسخ API فراهم می‌کند.
- درک محدودیت‌های GAQL: به توسعه‌دهندگان کمک می‌کند قوانین پیچیده را درباره اینکه کدام فیلدها سازگار هستند و منابع چگونه با یکدیگر مرتبط هستند یاد بگیرند.
- اشکال‌زدایی پُرسمان‌ها: وقتی پُرسمانی نامعتبر باشد، پیام‌های خطای خاصی ارائه می‌دهد که اغلب جزئیات بیشتری نسبت‌به خطای عمومی API دارد و گاهی‌اوقات جایگزین‌های معتبری پیشنهاد می‌دهد.
- کارایی منابع: از فراخوانی‌های غیرضروری میانای برنامه‌سازی کاربردی با پُرسمان‌هایی که محکوم به شکست هستند اجتناب می‌کند.
روش کار
«اعتبارسنج پُرسمان» پُرسمان GAQL شما را براساس طرح‌واره Google Ads API
و قوانین تعریف‌شده در Google Ads Query Language تجزیه می‌کند. این سیستم از فراداده استفاده می‌کند،
که بخش زیادی از آن ازطریق
GoogleAdsFieldService قابل‌دسترسی است، تا
بررسی‌هایی را انجام دهد، ازجمله:
- نحو و ساختار: اطمینان حاصل می‌کند که پُرسمان از دستور زبان GAQL صحیح پیروی می‌کند، ازجمله استفاده و ترتیب مناسب بندهایی مانند
SELECT،FROM،WHERE،ORDER BY،LIMIT، وPARAMETERS. - اعتبار فیلد: بررسی می‌کند که آیا همه فیلدهای مشخص‌شده (منابع، بخش‌ها، سنجه‌ها) وجود دارند و املای آن‌ها درست است یا نه.
- سازگاری منبع: تأیید می‌کند که فیلدهای انتخاب‌شده در
بند
SELECTبا منبع اصلی مشخص‌شده در بندFROMسازگار هستند. - سازگاری بخش و سنجه: اطمینان حاصل می‌کند که بخش‌ها و سنجه‌های
استفاده‌شده باهم در یک پُرسمان با یکدیگر و منبع در عبارت
FROMسازگار هستند. - الزامات عبارت: قوانینی مانند الزام برای
فیلدهای استفاده‌شده در عبارت‌های
ORDER BYو فیلدهای خاص استفاده‌شده در عبارت‌هایWHERE(مانند بخش‌ها) را برای حضور در عبارتSELECTنیز اعتبارسنجی می‌کند. - استفاده از عملگر: استفاده صحیح از عملگرها را در شرایط عبارت
WHEREبررسی می‌کند.
اگر پُرسمان معتبر باشد، ابزار آن را تأیید می‌کند. اگر مشکلی پیدا شود، پیام‌های خطایی ارائه می‌دهد که برای کمک به شناسایی دقیق مشکل طراحی شده‌اند و گاهی پیشنهادهایی برای رفع مشکل ارائه می‌دهد، مانند منابع سازگار برای یک سنجه خاص.
شروع کنید
برای استفاده از «اعتبارسنج پُرسمان Google Ads»:
- به اعتبارسنج پُرسمان بروید.
- پرسمان GAQL خود را وارد کنید.
- روی دکمه اعتبارسنجی پُرسمان کلیک کنید.
- پیام اعتبارسنجی را که در زیر ابزاره «اعتبارسنج پُرسمان» نشان داده می‌شود مرور کنید. پیام موفقیت نشان می‌دهد که پُرسمان معتبر است. درغیراین‌صورت، پیام خطایی که مشکل را شرح می‌دهد نمایش داده می‌شود. پیام‌های خطا شما را راهنمایی می‌کنند تا پُرسمان را اصلاح کنید. برای مثال، خطای ناسازگاری فیلد ممکن است منابع جایگزینی را فهرست کند که با سنجه یا بخشی که می‌خواهید پُرسمان کنید سازگار هستند.
برای توضیحات عمیق‌تر درباره مفاهیم و نحو GAQL، به راهنمای زبان پُرسمان Google Ads مراجعه کنید. برای ساختن و آزمایش کردن تعاملی پرسمان‌های GAQL، می‌توانید از پرسمان‌ساز و API Explorer نیز استفاده کنید.