سه‌شنبه، ۲۵ اوت ۲۰۲۶
نسخه اصلی دستیار توسعه‌دهنده Google Ads API اکنون دردسترس است. این نسخه دستیار را از راه‌اندازی پروژه مستقل به معماری افزونه یکپارچه منتقل می‌کند که برای آوردن قابلیت‌های تخصصی Google Ads API مستقیماً به گردش کار عامل هوش مصنوعی طراحی شده است.
این چیست؟
«دستیار توسعه‌دهنده Google Ads API» تخصص عمیق در دامنه Google Ads را به محیط‌های کدنویسی هوش مصنوعی مانند Antigravity و Claude Code می‌آورد. این راهنما دستیار هوش مصنوعی شما را به ابزارها و حفاظ‌های تخصصی مجهز می‌کند. توابع عبارت‌اند از:
- تولید کد اصطلاحی: کد ادغام آزمایش‌شده و با بهترین عملکرد را در Python، Java، PHP، NET.، و Ruby ایجاد کنید.
- اعتبارسنجی پُرسمان‌های GAQL: به‌طور خودکار نحو، سازگاری فیلد، بخش‌بندی تاریخ، و قوانین ظهور صفر را قبل‌از اجرای پُرسمان‌ها درستی‌سنجی می‌کند.
- بازرسی طرح‌واره‌های Protobuf: کشف فیلدهای منبع، انواع داده، و تعاریف enum برای هر نسخه فعال Google Ads API به‌صورت درخواستی برای اطمینان از معتبر بودن فیلدهای پُرسمان GAQL.
- عیب‌یابی مشکلات میانای برنامه‌سازی کاربردی: تشخیص خرابی‌های بارگذاری تبدیل آفلاین، پیمایش سلسله‌مراتب حساب مدیر، و ساخت فیلترهای فهرستگان «عملکرد بیشینه». می‌توانید سؤالات را با زبان طبیعی مطرح کنید، مثلاً «همه آگهی‌های حسابم را که مشکل دارند نشان بده و نحوه رفع مشکل آن‌ها را توصیه کن.»
- پاسخ به سؤالات API: دستیار با ترکیب قوانین معماری Google Ads API جاسازی‌شده با بازرسی طرح‌واره Protobuf محلی و پویا، به سؤالات پاسخ می‌دهد تا راهنمایی‌های دقیق نسخه و تکه‌کدهای تأییدشده را ارائه دهد. این ابزار به‌جای تکیه صرف بر آموزش مدل عمومی، پاسخ‌های خود را مستقیماً براساس تعاریف رسمی میانای برنامه‌سازی کاربردی و کد منبع کتابخانه مشتری ارائه می‌دهد. یک نمونه سؤال می‌تواند این باشد: «مجموعه هم‌رسانی‌شده چیست و چگونه از آن استفاده کنم؟»
- گزارش‌دهی موردی: می‌توانید داده‌های عملکرد را به زبان انگلیسی ساده درخواست کنید و دستیار فوراً پُرسمان‌های GAQL موردنیاز را مستقیماً در حساب Google Ads شما می‌سازد، اعتبارسنجی می‌کند، و اجرا می‌کند. این افزونه نتایج زنده را به‌صورت جدول‌های تمیز و قالب‌بندی‌شده به گپ شما برمی‌گرداند و گزارش‌دهی موردی و بررسی سنجه‌ها را آسان می‌کند. اگر می‌خواهید نتایج را ذخیره کنید، از آن بخواهید «نتایج را به‌عنوان فایل CSV در <فهرست راهنمای شما> ذخیره کند» و می‌توانید آن را برای تجزیه‌وتحلیل در صفحه‌گسترده بار کنید.
پشتیبانی از Antigravity و Claude Code
این نسخه پخش پشتیبانی از پلاتفرم دوگانه را معرفی می‌کند:
- Antigravity: پشتیبانی بومی از محیط‌های توسعه‌دهنده Antigravity با ثبت افزونه سراسری و فضای کاری.
- کد Claude: ادغام کامل با سیستم افزایه CLI «کد Claude»، ازجمله فرمان‌های خط مورب سفارشی (مانند
/validate-gaql،/inspect-object،/troubleshoot-conversions، و/get-cids).
اسکریپت‌های نصب یکپارچه برای Linux، macOS (bash)، و Windows (PowerShell) دردسترس است تا مدیریت چرخه حیات یکسانی در هر سه پلاتفرم ارائه شود.
عملکرد بهبودیافته
- کاهش مصرف توکن: افشای تدریجی قوانین و طرح‌واره‌ها فقط بافت موردنیاز برای یک تکلیف خاص را بار می‌کند و سربار توکن پیام‌واره را کاهش می‌دهد.
- زمان پاسخ سریع‌تر: اجرای مهارت درخواستی و مسیریابی فرمان هدفمند، تکمیل سریع‌تر تکلیف را از ابتدا تا انتها ارائه می‌دهد.
- استفاده کمتر از CPU: خطوط لوله اجرای ساده‌شده، سربار فرایند پس‌زمینه را درطول جلسات توسعه حذف می‌کنند.
- کاهش ورودی/خروجی دیسک: کاهش تعداد فایل‌های غیرضروری در درخت افزونه از اسکن ده‌ها هزار فایل protobuf/SDK استفاده‌نشده توسط ناظران فایل، خطایاب‌های نحوی، و نمایه‌سازهای IDE جلوگیری می‌کند.
- ردپای حافظه (RAM) کمتر و سربار دیمون صفر: مهارت‌ها و فرمان‌ها اکنون به‌صورت گذرا به‌عنوان فرایندهای فرزند سریع فقط هنگام فراخوانی اجرا می‌شوند و مصرف منابع سیستم را در حالت بیکار به صفر می‌رسانند.
- وضوح طرح‌واره Protobuf و نسخه API ذخیره‌شده در حافظه نهان: دستیار هنگام بازرسی فیلدها، منابع، و شمارش‌های استاندارد از برقراری تماس‌های API بازتابی یا فراداده ازراه‌دور تکراری اجتناب می‌کند.
- اجرای فرمان قطعیتی درمقابل استدلال مدل زبانی بزرگ چندنوبتی: به‌جای اینکه مدل زبانی بزرگ نحو GAQL را در ۳ تا ۴ رفت‌وبرگشت حدس بزند یا به‌صورت تکرارشونده اشکال‌زدایی کند، اعتبارسنج محلی فیلدها، منابع، سنجه‌های با نمایش صفر، و بندهای تاریخ را در یک مرحله بررسی می‌کند.
نسخه پخش اصلی ساخته‌شده بر معماری افزونه مدرن
این نسخه پخش اصلی است که با نسخه‌های پخش قبلی سازگار نیست. نسخه‌های قبلی به ساختار پروژه فضای کاری محلی متکی بودند. این نسخه براساس معماری افزونه استانداردشده‌ای ساخته شده است که برای دردسترس بودن در سطح جهانی نصب شده است.
مدولار کردن قوانین، مهارت‌ها، و فرمان‌های تشخیصی در یک بسته افزایه مستقل به توسعه‌دهندگان اجازه می‌دهد تا دستیار را در چندین محیط و پروژه نصب، به‌روزرسانی، و مدیریت کنند.
برای جزئیات فنی درباره معماری افزونه، README.md را ببینید.
درحال شروع کردن
به‌دلیل تغییرات معماری در این نسخه، قبل‌از نصب، اسناد را مرور کنید:
- برای پیش‌نیازها و آماده‌سازی محیط، README_BEFORE_INSTALLATION.md را بخوانید.
- دستورالعمل‌های نصب را در README.md دنبال کنید.
بازخوردتان را تقاضا می‌کنیم
بااستفاده از فرم نظرسنجی، بازخوردتان را هم‌رسانی کنید، مشکلات را گزارش کنید، و قابلیت‌های جدید پیشنهاد دهید:
برچسب‌ها: google-ads-api، release