«پرسمان‌ساز 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 Explorer آزمایش کنید یا با «اعتبارسنج پرسمان» اعتبار آن را بسنجید.
API Explorer
پس‌از ساختن پُرسمان، روی امتحان کردن در API Explorer کلیک کنید تا پُرسمانتان در API Explorer باز شود. پرسمان شما به‌طور خودکار در بدنه درخواست پر می‌شود و سپس می‌توانید پرسمانتان را با اجرا کردن آن در داده‌های حسابتان آزمایش کنید. برای اطلاعات بیشتر درباره این ابزار، به API Explorer مراجعه کنید.
اعتبارسنج پرسمان
وقتی روی وارد کردن یا ویرایش پُرسمان کلیک می‌کنید، «اعتبارسنج پُرسمان» باز می‌شود. از «اعتبارسنج پُرسمان» برای اعتبارسنجی نحو پُرسمانتان استفاده کنید. هر پرسمانی که کاملاً ازطریق «پرسمان‌ساز» ساخته شده باشد ازقبل نحو صحیح را دارد، اما اگر با منبعی که از آن پرسمان می‌کنید آشنا باشید، «اعتبارسنج پرسمان» روشی سریع برای وارد کردن پرسمان و بررسی اعتبار آن ارائه می‌دهد. برای اطلاعات بیشتر درباره این ابزار، به اعتبارسنج پُرسمان مراجعه کنید.