«دستیار توسعه‌دهنده 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: برای اجرای گزارش‌های فقط خواندنی و پرسش‌های آزمایشی دربرابر حساب شما به میانای برنامه‌سازی کاربردی زنده متصل می‌شود. برای اعتبارسنجی سریع فیلد، مستقیماً طرحوارههای Protobuf محلی را بازرسی می‌کند.
- نگهبانان ایمنی: این سیستم به‌گونه‌ای طراحی شده است که از پروتکل‌های سخت‌گیرانه پیروی کند. اگر یک دستورگان لنت نشده باشد، به شما اجازه نمی‌دهد آن را اجرا کنید، و اگر یک پُرسمان از بررسی اعتبارسنجی برنامه‌ریزی‌شده عبور نکرده باشد، به شما اجازه نمی‌دهد آن را ارسال کنید.
کارهایی که «دستیار» انجام می‌دهد
به زبان ساده، دستیار محافظ و شتاب‌دهنده شما است.
- از بروز اشتباه جلوگیری می‌کند: قبل‌از اجرا، کد و پُرسمان‌ها را دربرابر طرحوارههای فعال میانای برنامه‌سازی کاربردی درستی‌سنجی می‌کند و خطاهای سازگاری و دستور زبان را قبل‌از اینکه به میانای برنامه‌سازی کاربردی زنده برسند متوقف می‌کند.
- با نقشه آشنا است: با جغرافیای «میانای برنامه‌سازی کاربردی Google Ads» آشنا است—داده‌ها کجا هستند و چگونه می‌توان آن‌ها را به‌طور کارآمد پُرسمان کرد.
- کارهای خسته‌کننده را خودکار می‌کند: کد کتابخانه مشتری تکراری می‌نویسد، گزارش‌ها را در جدول‌های تمیز پایانه قالب‌بندی می‌کند، و کارهای تکراری کتابخانه مشتری را مدیریت می‌کند.
- گردش‌های کار پیچیده را عیب‌یابی می‌کند: تشخیص‌های عمیقی روی بارگذاری‌های تبدیل آفلاین اجرا می‌کند، سلسله مراتب حساب مدیر را حل‌وفصل می‌کند، و ساختارهای پویش پیچیده مثل فیلترهای فهرستگان «عملکرد بیشینه» و کنارگذاری‌های نشانی وب را پیکربندی می‌کند.
- گزارش‌های موردی را به‌صورت زنده جاری‌سازی می‌کند: داده‌های عملکرد را به زبان انگلیسی ساده درخواست کنید و دستیار مستقیماً پُرسمان‌های GAQL را در حساب شما می‌سازد، اعتبارسنجی می‌کند، و اجرا می‌کند، و نتایج قالب‌بندی‌شده را به پایانه شما جاری‌سازی می‌کند یا آن‌ها را به CSV صادر می‌کند.
- به‌روز می‌ماند: با بازرسی طرحوارهها و مستندات محلی Protobuf برای نسخه فعال API، به شما کمک می‌کند از فیلدهای منسوخ و قوانین قدیمی اجتناب کنید.
«دستیار توسعه‌دهنده Google Ads API» مبارزه «توسعه‌دهنده دربرابر API» را به همکاری «توسعه‌دهنده + هوش مصنوعی» تبدیل می‌کند که کد ایمن، اصطلاحی، و ازنظر معماری سالم تولید می‌کند.
معماری و عملکرد (نسخه ۴.۰.۰)
نسخه ۴.۰.۰ دستیار را از راه‌اندازی پروژه مستقل به معماری افزونه مدرن و جهانی منتقل می‌کند:
- سربار صفر دیمون: مهارت‌ها و فرمان‌های تشخیصی به‌صورت گذرا به‌عنوان فرایندهای فرزند سبک فقط هنگام فراخوانی اجرا می‌شوند و مصرف منابع سیستم را در زمان بیکاری به صفر می‌رسانند.
- شفاف‌سازی پیش‌رونده بافت: قوانین و طرحوارهها فقط درصورت درخواست و زمانی که به تکلیف فعال شما مربوط باشند بار می‌شود، که این امر مصرف کد و تأخیر پیام‌واره را به‌طور قابل‌توجهی کاهش می‌دهد.
- کاهش ورودی/خروجی دیسک: حذف فایل‌های غیرضروری کیت توسعه نرم‌افزار از درخت افزونه مانع از این می‌شود که نمایه‌سازهای IDE، خطایاب‌های نحوی، و ناظران فایل ده‌ها هزار فایل استفاده‌نشده را اسکن کنند.
- پشتیبانی از میزبان چندپلاتفرمی: به‌طور یکپارچه در محیط‌های Google Antigravity و Claude Code با اسکریپت‌های نصب یکپارچه در Linux، macOS، و Windows کار می‌کند.
مراحل بعدی
- نصب و پیکربندی «دستیار توسعه‌دهنده Google Ads API»
- درباره مهارت‌های کارگزار Google Ads API بیشتر بدانید
- با سرور Google Ads API MCP آشنا شوید