«دستیار توسعه‌دهنده Google Ads API» (نسخه ۴.۰.۰) یک روبات گپ عمومی نیست. این سیستم یک سیستم کنترل مأموریت تخصصی برای مهندسی تبلیغات با بهره‌گیری از هوش مصنوعی است که بر چارچوب‌های عامل Google Antigravity و Claude Code ساخته شده است.
پرسش و پاسخ به زبان طبیعی و بافت ویژه کسب‌وکار
می‌توانید با مطرح کردن سؤالات و درخواست‌ها به زبان ساده و طبیعی با «دستیار» تعامل کنید. «دستیار» قصد شما را تحلیل می‌کند، با طرح‌واره‌های رسمی API مشورت می‌کند، و توضیحات واضح، کد آماده تولید، یا داده‌های زنده ارائه می‌دهد:
- توضیحات به زبان طبیعی: درباره مفاهیم Google Ads API، سلسله‌مراتب منابع، سنجه‌های گزارش‌دهی، یا قوانین بخش‌بندی سؤال بپرسید تا نمای کلی مفهومی و توضیحات معماری واضحی دریافت کنید.
- تولید کد هدفمند: وقتی تکلیفتان نیاز به پیاده‌سازی دارد، «دستیار» تکه‌کدهای کتابخانه مشتری اصطلاحی و آماده تولید، اسکریپت‌های جهش، یا پُرسمان‌های GAQL متناسب با زبان برنامه‌نویسی و مورد استفاده شما ارائه می‌دهد.
- عیب‌یابی و تشخیص خطا: پیام‌های خطای API، کدهای وضعیت gRPC، یا رفتارهای ادغام غیرمنتظره را جای‌گذاری کنید. «دستیار» علت ریشه‌ای را تشخیص می‌دهد، توضیح می‌دهد که چرا مشکل رخ داده است، و اصلاحات کد یا رفع پیکربندی لازم را ارائه می‌دهد.
- گزارش‌دهی موردی: داده‌های عملکرد حساب و سنجه‌های پویش را به زبان ساده درخواست کنید. «دستیار» پُرسمان‌های GAQL را مستقیماً در حساب شما می‌سازد، اعتبارسنجی می‌کند، و اجرا می‌کند، نتایج قالب‌بندی‌شده را در پایانه شما نمایش می‌دهد، یا آن‌ها را به CSV صادر می‌کند.
- بافت ویژه کسب‌وکار از پایگاه کد شما: مخزن پروژه و پایگاه کد خودتان را بااستفاده از پارامتر راه‌اندازی
--context_dirثبت کنید. «دستیار» با تجزیه‌وتحلیل خطوط لوله داده‌های موجود، ابزارهای کمکی، و منطق کسب‌وکار شما، توضیحات، عیب‌یابی، و کد تولیدشده را به‌گونه‌ای سفارشی می‌کند که به‌طور یکپارچه با سیستم‌های داخلی شما ادغام شود.
نمای کلی: حل اصطکاک انطباق بالا
مشکل اساسی‌ای که این «دستیار» حل می‌کند، اضافه‌بار شناختی و زحمت فنی است.
Google Ads API یکی از قدرتمندترین و درعین‌حال پیچیده‌ترین میاناهای برنامه‌سازی کاربردی موجود است. این میانای برنامه‌سازی کاربردی دارای نسخه‌بندی دقیق، زبان پُرسمان منحصربه‌فرد (GAQL)، ساختارهای میان‌گیر پروتکل عمیقاً تودرتو، و الزامات ایمنی سخت‌گیرانه است. توسعه‌دهنده اغلب درصد قابل‌توجهی از زمان خود را صرف مبارزه با API ازطریق اشکال‌زدایی خطاهای gRPC، جستجوی سازگاری فیلد، و رفع مشکلات خطایاب نحوی می‌کند، به‌جای اینکه منطق کسب‌وکار واقعی را بسازد.
«دستیار» این مشکل را در نسخه ۴.۰.۰ با معرفی معماری افزونه مدولار که توسط مهارت‌های تخصصی و آزمایش‌شده و فرمان‌های خط مورب داخلی پشتیبانی می‌شود، حل می‌کند. این ابزار به‌عنوان یک میان‌افزار متخصص خودکار عمل می‌کند و کارهای تکراری و خسته‌کننده مانند اعتبارسنجی نسخه، کشف طرح‌واره، و بررسی کد را انجام می‌دهد. این امر به توسعه‌دهنده اجازه می‌دهد تا به‌جای تمرکز بر نحو، بر سطح هدف تمرکز کند.
برپایه طرح‌واره‌های رسمی، نه حدس و گمان
مدل‌های زبانی بزرگ استاندارد اغلب با میاناهای برنامه‌سازی کاربردی مختص دامنه مشکل دارند زیرا به داده‌های آموزشی عمومی متکی هستند که با انتشار نسخه‌های جدید میانای برنامه‌سازی کاربردی به‌سرعت قدیمی می‌شوند.
«دستیار توسعه‌دهنده Google Ads API» این مشکل را با ترکیب قوانین معماری Google Ads API جاسازی‌شده با بازرسی طرح‌واره Protobuf محلی و پویا حل می‌کند:
- اعتبارسنجی قطعی: به‌جای تکیه بر حدس‌های تکراری مدل زبانی بزرگ در چندین رفت‌وبرگشت، دستیار یک خط لوله اعتبارسنجی محلی ۴ مرحله‌ای را اجرا می‌کند که سازگاری فیلد، روابط منابع، قوانین بدون ظهور، و بخش‌بندی تاریخ را در یک مرحله تأیید می‌کند.
- جستجوی طرح‌واره دقیق نسخه: این ویژگی تعاریف منبع Protobuf، انواع داده، و مقادیر شمارشی را مستقیماً از طرح‌واره‌های رسمی API برای نسخه فعال API بررسی می‌کند و از پرسمان‌های تکراری فراداده از راه دور جلوگیری می‌کند.
- مستندسازی کتابخانه مشتری رسمی: تولید کد مستقیماً در کتابخانه‌های مشتری رسمی Google Ads در Python، Java، PHP، NET.، و Ruby مستندسازی می‌شود.
قیاس: آزمایشگاه تخصصی پژوهش و تشخیص
دستیار را به‌عنوان یک آزمایشگاه تحقیقاتی با فناوری پیشرفته برای جراح درنظر بگیرید.
- جراح (توسعه‌دهنده): شما می‌دانید چه عملی باید انجام شود (برای مثال، «باید عملکرد PMax را تحلیل کنم»).
- تجهیزات آزمایشگاهی (میانای برنامه‌سازی کاربردی): این‌ها ابزارهای قدرتمندی هستند که برای انجام جراحی لازم‌اند، اما پیچیده هستند و به کالیبره کردن دقیق نیاز دارند.
- دستیار آزمایشگاه (این ابزار): قبل‌از اینکه بیمار را لمس کنید، دستیار آزمایشگاه از مهارت‌های تخصصی و فرمان‌های داخلی برای انجام کارهای زیر استفاده می‌کند:
- بررسی راهنماها: جدیدترین پروتکل‌های میانای برنامه‌سازی کاربردی را به‌طور خودکار درستی‌سنجی می‌کند و
ساختارهای منبع را درحین اجرا بازرسی می‌کند (
inspect_object//inspect-object). - پیش‌آزمایش ابزارها: اجرای آزمایشی قطعی را روی پُرسمان‌های شما
بااستفاده از اعتبارسنجی میانای برنامه‌سازی کاربردی زنده (
validate_gaql//validate-gaql) اجرا می‌کند تا خطاها را قبل‌از وقوع شناسایی کند. - استریل کردن محیط: کد شما را بااستفاده از خطوط لوله خطایاب نحوی سخت‌گیرانه (
ruffخطایابی نحوی) قالب‌بندی و پاک‌سازی می‌کند تا باعث خطاهای سیستم نشود. - نظارت بر موارد حیاتی: استثناهای میانای برنامه‌سازی کاربردی را زیرنظر می‌گیرد و گردش‌های کاری تشخیصی پیشرفته را برای عملیات پیچیده مانند تبدیل‌های آفلاین (
troubleshoot_conversions//troubleshoot-conversions) اجرا می‌کند. - توضیح مفاهیم: مفاهیم پیچیده را به زبان روزمره با قیاس‌های دنیای واقعی توضیح می‌دهد (
/explain،/step-by-step،/assistant-tutorial).
- بررسی راهنماها: جدیدترین پروتکل‌های میانای برنامه‌سازی کاربردی را به‌طور خودکار درستی‌سنجی می‌کند و
ساختارهای منبع را درحین اجرا بازرسی می‌کند (
اتصال متقابل: پل «ایمنی در اولویت»
«دستیار» به‌عنوان پلی عمل می‌کند که چهار «جهان» متمایز را در
پروژه شما به هم متصل می‌کند و تحت کنترل قراردادهای کنترلی (AGENTS.md / CLAUDE.md) است:
- زمینه کاربر: به اهداف سطح بالای شما گوش می‌دهد و آن‌ها را به یک استراتژی فنی ترجمه می‌کند.
- فضای کاری محلی: این فضا «چشم و دست» در فهرست راهنمای پروژه شما دارد. این مدل می‌تواند کد موجود را بخواند و کد جدیدی برای استفاده در آینده بنویسد، و درعین‌حال جداسازی دقیقی را حفظ کند.
- Google Ads API: به میانای برنامه‌سازی کاربردی زنده متصل می‌شود تا گزارش‌های فقط خواندنی را اجرا کند و پُرسمان‌ها را در حساب شما آزمایش کند. برای اعتبارسنجی سریع فیلد، مستقیماً طرح‌واره‌های Protobuf محلی را بازرسی می‌کند.
- دروازه‌بانان ایمنی: این مدل برای پیروی از پروتکل‌های سخت‌گیرانه طراحی شده است. اگر اسکریپت لینت نشده باشد، به شما اجازه نمی‌دهد آن را اجرا کنید و اگر پُرسمان از بررسی اعتبارسنجی برنامه‌ای عبور نکرده باشد، به شما اجازه نمی‌دهد آن را ارسال کنید.
«دستیار» چه کاری انجام می‌دهد
به زبان ساده، دستیار محافظ و شتاب‌دهنده شما است.
- از اشتباهات جلوگیری می‌کند: کد و پُرسمان‌ها را پیش‌از اجرا دربرابر طرح‌واره‌های فعال میانای برنامه‌سازی کاربردی اعتبارسنجی می‌کند و خطاهای نحوی و سازگاری را پیش‌از رسیدن به میانای برنامه‌سازی کاربردی فعال متوقف می‌کند.
- نقشه را می‌شناسد: جغرافیای Google Ads API را درک می‌کند—داده‌ها کجا قرار دارند و چگونه می‌توان به‌طور مؤثر از آن‌ها پُرسمان کرد.
- کارهای خسته‌کننده را خودکار می‌کند: کد کتابخانه کارخواه تکراری می‌نویسد، گزارش‌ها را در جدول‌های تمیز پایانه قالب‌بندی می‌کند، و کارهای زیرساختی کتابخانه کارخواه را انجام می‌دهد.
- عیب‌یابی گردش‌های کاری پیچیده: این مدل تشخیص عمیق را روی بارگذاری‌های تبدیل آفلاین اجرا می‌کند، سلسله‌مراتب حساب مدیر را حل می‌کند، و ساختارهای پیچیده پویش مانند فیلترهای فهرستگان «عملکرد بیشینه» و مستثنا کردن نشانی‌های وب را پیکربندی می‌کند.
- گزارش‌های موردی را به‌صورت زنده جاری‌سازی می‌کند: داده‌های عملکرد را به زبان انگلیسی ساده درخواست کنید و دستیار، پُرسمان‌های GAQL را مستقیماً در حساب شما می‌سازد، اعتبارسنجی می‌کند، و اجرا می‌کند، و نتایج قالب‌بندی‌شده را به پایانه شما جاری‌سازی می‌کند یا آن‌ها را به CSV صادر می‌کند.
- به‌روز می‌ماند: با بررسی طرح‌واره‌های Protobuf محلی و اسناد برای نسخه فعال API، به شما کمک می‌کند از فیلدهای منسوخ‌شده و قوانین قدیمی اجتناب کنید.
«دستیار توسعه‌دهنده Google Ads API» چالش «توسعه‌دهنده دربرابر میانای برنامه‌سازی کاربردی» را به همکاری «توسعه‌دهنده + هوش مصنوعی» تبدیل می‌کند که کدی ایمن، اصطلاحی، و ازنظر معماری صحیح تولید می‌کند.
معماری و عملکرد (نسخه ۴.۰.۰)
نسخه ۴.۰.۰ دستیار را از راه‌اندازی پروژه مستقل به معماری افزونه مدرن و جهانی منتقل می‌کند:
- سربار صفر دیمون: مهارت‌ها و فرمان‌های عیب‌یابی به‌صورت گذرا به‌عنوان فرایندهای فرزند سبک فقط هنگام فراخوانی اجرا می‌شوند و مصرف منابع سیستم را در حالت بیکار به صفر می‌رسانند.
- شفاف‌سازی بافت پیش‌رونده: قوانین و طرح‌واره‌ها فقط درصورت نیاز و زمانی که به تکلیف فعال شما مربوط باشند بار می‌شود، که این امر مصرف کد و تأخیر پیام‌واره را به‌طور قابل‌توجهی کاهش می‌دهد.
- کاهش ورودی/خروجی دیسک: حذف فایل‌های غیرضروری کیت توسعه نرم‌افزار از درخت افزونه مانع از اسکن ده‌ها هزار فایل استفاده‌نشده توسط نمایه‌سازهای IDE، خطایاب‌های نحوی، و ناظران فایل می‌شود.
- پشتیبانی از میزبان چندپلاتفرمی: به‌طور یکپارچه در محیط‌های Google Antigravity و Claude Code با اسکریپت‌های نصب یکپارچه در Linux، macOS، و Windows کار می‌کند.
مراحل بعدی
- نصب و پیکربندی «دستیار توسعه‌دهنده Google Ads API»
- آشنایی با مهارت‌های عامل Google Ads API
- آشنایی با سرور MCP مربوط به Google Ads API