«پرسمان‌ساز Google Ads» ابزاری تعاملی است که برای کمک به شما در ساختن و اعتبارسنجی کردن پُرسمان‌ها بااستفاده از «زبان پُرسمان Google Ads» (GAQL) طراحی شده است. چه با GAQL آشنایی نداشته باشید و چه کاربر باتجربه‌ای باشید، «پرسمان‌ساز» می‌تواند فرایند واکشی داده‌های دقیقی را که از Google Ads API نیاز دارید ساده کند.
مزايا
- سهولت استفاده: فرایند نوشتن پُرسمان‌های GAQL را ساده می‌کند، بدون اینکه نیاز به آشنایی با نحو خاص و فیلدهای دردسترس باشد.
- قابلیت کشف: به کاوش و یافتن منابع، فیلدها، بخش‌ها، و سنجه‌های دردسترس در مدل داده Google Ads API کمک می‌کند.
- کاهش خطاها: با ارائه یک رابط ساختاریافته و منوهای کرکره‌ای از گزینه‌های معتبر، به جلوگیری از خطاهای نحوی و غلط‌های املایی کمک می‌کند و تضمین می‌کند که پُرسمان تولیدشده معتبر است.
- ساخت سریع‌تر پُرسمان: با خودکارسازی تولید رشته‌های پُرسمان، فرایند توسعه را سرعت می‌بخشد.
- اعتبارسنجی: این ابزار با API Explorer و Query Validator پیوند دارد تا پُرسمان‌ها را قبل‌از اجرا با قوانین میانای برنامه‌سازی کاربردی بررسی کند.
روش کار
«سازنده پُرسمان Google Ads» یک میانای کاربرپسند برای سرهم کردن دیداری پُرسمان‌های GAQL ارائه می‌دهد. گردش کار اصلی در اینجا آمده است:
- انتخاب منبع: با انتخاب منبع اصلی از زبانه
مرجع برای نسخه‌ای که
می‌خواهید پُرسمان کنید شروع کنید. این منبع در بند
FROMقرار دارد. منابع نشان‌دهنده نهادهای درون Google Ads هستند، مثلcampaign،ad_group، یاkeyword_view. سازنده همه منابع دردسترس را فهرست می‌کند. - انتخاب فیلدها: پس‌از انتخاب منبع، ابزار همه فیلدهای قابل‌انتخاب را نمایش می‌دهد، ازجمله مشخصه‌ها، بخش‌ها، و سنجه‌های مربوط به آن منبع و منابع منسوب به آن (که به‌طور ضمنی قابل‌پیوستن هستند). می‌توانید
چارگوش‌ها را علامت بزنید تا فیلدها را در بند
SELECTبگنجانید. هم‌زمان با انتخاب کردن، ابزار به‌طور پویا رشته پُرسمان GAQL مربوطه را تولید می‌کند، خطاها را نمایش می‌دهد، و ترکیب‌های فیلد ناسازگار را فیلتر می‌کند. - اعمال فیلتر: برای فیلتر کردن نتایج، شرایط عبارت
WHEREرا اضافه کنید. سازنده به شما کمک می‌کند فیلدها، عملگرها، و مقادیر را انتخاب کنید، و از درست بودن نحو مطمئن شوید. - ترتیب نتایج: ترتیب مرتب‌سازی را بااستفاده از عبارت
ORDER BYمشخص کنید. - تنظیم محدودیت‌ها: یک بند
LIMITبرای کنترل تعداد نتایج برگشتی اضافه کنید. - اعتبارسنجی: این ابزار ذاتاً شما را به‌سمت ترکیب‌های فیلد معتبر هدایت می‌کند و همچنین به API Explorer پیوند می‌دهد تا بتوانید پُرسمان خود را دربرابر داده‌های حسابتان آزمایش کنید. همچنین یک اعتبارسنجی پرسمان جداگانه وجود دارد که می‌توانید پرسمان‌های GAQL نوشته‌شده به‌صورت دستی را در آن جای‌گذاری و بررسی کنید.
- صادر کردن: پس‌از اینکه از پُرسمانتان راضی شدید، رشته GAQL آزمایش‌شده و ازنظر دستور زبان صحیح را در درخواست‌های کارخواه
GoogleAdsService.SearchیاSearchStreamکپی و جای‌گذاری کنید.
سازنده اطمینان حاصل می‌کند که فیلدها، بخش‌ها، و سنجه‌های انتخاب‌شده سازگار هستند و می‌توانند باهم در یک پُرسمان واحد استفاده شوند، و به فراداده‌های زیربنایی Google Ads API ارجاع می‌دهند.
شروع کنید
دو راه برای رفتن به «پرسمان‌ساز» وجود دارد: ازطریق صفحه‌ای خاص در اسناد مرجع گزارش‌دهی، یا کاوش از صفحه نمای کلی «پرسمان‌ساز».
از اسناد مرجع گزارش‌دهی
- با اسناد مرجع گزارش‌دهی شروع کنید، و منبع خاصی را برای شروع در فهرست همه منابع انتخاب کنید. یا مستقیماً از پنجره پیمایش سمت راست به منبع بروید.
- روی کمک گرفتن برای ساختن پُرسمان کلیک کنید تا به «پُرسمان‌ساز» برای آن منبع خاص بروید.
از صفحه نمای کلی «پرسمان‌ساز»
به بخش سازنده پُرسمان در اسناد مرجع گزارش‌دهی بروید و منبعی را که می‌خواهید کاوش کنید انتخاب کنید.
ادغام با ابزارهای دیگر
«پرسمان‌ساز» با ابزارهای دیگر در «جعبه‌ابزار توسعه‌دهنده Google Ads API» ادغام شده است. می‌توانید پُرسمانی را که در «سازنده پُرسمان» ساخته شده است در «کاوشگر API» آزمایش کنید یا آن را با «اعتبارسنج پُرسمان» اعتبارسنجی کنید.
API Explorer
پس‌از ساختن پُرسمان، روی امتحان کردن در API Explorer کلیک کنید تا پُرسمانتان در API Explorer باز شود. پُر کردن خودکار پُرسمان شما در بدنه درخواست، و سپس می‌توانید پُرسمان خود را با اجرای آن دربرابر داده‌های حسابتان آزمایش کنید. برای اطلاعات بیشتر درباره این ابزار، به API Explorer مراجعه کنید.
اعتبارسنج پُرسمان
وقتی روی وارد کردن یا ویرایش پُرسمان کلیک می‌کنید، «اعتبارسنج پُرسمان» باز می‌شود. از «اعتبارسنج پُرسمان» برای اعتبارسنجی نحو پُرسمانتان استفاده کنید. هر پُرسمانی که به‌طور کامل ازطریق «سازنده پُرسمان» ساخته شده باشد از قبل نحو صحیح را دارد، اما اگر با منبعی که پُرسمان می‌کنید آشنا باشید، «اعتبارسنج پُرسمان» روشی سریع برای وارد کردن پُرسمان و بررسی اعتبار آن ارائه می‌دهد. برای اطلاعات بیشتر درباره این ابزار، اعتبارسنجی پُرسمان را ببینید.