دستیار توسعهدهنده API گوگل ادز (نسخه ۴.۰.۰) یک چتبات عمومی نیست. این یک سیستم کنترل ماموریت تخصصی برای مهندسی تبلیغات مبتنی بر هوش مصنوعی است که بر اساس چارچوبهای Google Antigravity و Claude Code ساخته شده است.
پرسش و پاسخ به زبان طبیعی و زمینههای خاص کسب و کار
شما میتوانید با پرسیدن سوالات و درخواستها به زبان ساده و طبیعی با دستیار (Assistant) تعامل داشته باشید. دستیار، هدف شما را تجزیه و تحلیل میکند، از طرحهای رسمی API استفاده میکند و توضیحات واضح، کد آماده برای تولید یا دادههای زنده ارائه میدهد:
- توضیحات زبان طبیعی: در مورد مفاهیم API گوگل ادز، سلسله مراتب منابع، معیارهای گزارشدهی یا قوانین تقسیمبندی سوال بپرسید تا خلاصههای مفهومی و توضیحات معماری واضحی دریافت کنید.
- تولید کد هدفمند: هنگامی که وظیفه شما نیاز به پیادهسازی دارد، دستیار، قطعه کدهای کتابخانه کلاینت اصطلاحی و آماده برای تولید، اسکریپتهای جهش یا کوئریهای GAQL متناسب با زبان برنامهنویسی و مورد استفاده شما را ارائه میدهد.
- عیبیابی و تشخیص خطا: پیامهای خطای API، کدهای وضعیت gRPC یا رفتارهای غیرمنتظره ادغام را وارد کنید. دستیار علت اصلی را تشخیص میدهد، توضیح میدهد که چرا مشکل رخ داده است و اصلاحات لازم کد یا رفع پیکربندی را ارائه میدهد.
- گزارشدهی موردی: دادههای عملکرد حساب و معیارهای کمپین را به زبان ساده درخواست کنید. دستیار، پرسوجوهای GAQL را مستقیماً در حساب شما ایجاد، اعتبارسنجی و اجرا میکند و نتایج قالببندیشده را در ترمینال شما نمایش میدهد یا آنها را به CSV صادر میکند.
- زمینه خاص کسب و کار از پایگاه کد شما: مخزن پروژه و پایگاه کد خود را با استفاده از پارامتر تنظیم
--context_dirثبت کنید. با تجزیه و تحلیل خطوط داده موجود، ابزارهای کمکی و منطق کسب و کار شما، دستیار توضیحات، عیبیابی و کد تولید شده خود را متناسب با سیستمهای داخلی شما تنظیم میکند.
تصویر کلی: حل اصطکاک ناشی از انطباق بالا
مشکل اساسی که این دستیار حل میکند، بار شناختی بیش از حد و زحمت فنی است.
رابط برنامهنویسی کاربردی گوگل ادز یکی از قدرتمندترین - اما در عین حال پیچیدهترین - رابطهای برنامهنویسی کاربردی موجود است. این رابط دارای نسخهبندی دقیق، یک زبان پرسوجوی منحصر به فرد (GAQL)، ساختارهای بافر پروتکل تو در تو و الزامات ایمنی سختگیرانه است. یک توسعهدهنده اغلب درصد قابل توجهی از وقت خود را صرف اشکالزدایی خطاهای gRPC، جستجوی سازگاری فیلدها و رفع مشکلات linter میکند، به جای اینکه منطق تجاری واقعی را بسازد.
دستیار (Assistant) در نسخه ۴.۰.۰ این مشکل را با معرفی یک معماری افزونه ماژولار که توسط مهارتهای تخصصی و آزمایششده و دستورات اسلش داخلی پشتیبانی میشود، حل میکند. این نرمافزار به عنوان یک میانافزار متخصص خودکار عمل میکند و زحمت اعتبارسنجی نسخه، کشف طرحواره و کدگذاری را بر عهده میگیرد، که به توسعهدهنده اجازه میدهد در سطح هدف به جای نحو عمل کند.
مبتنی بر طرحوارههای رسمی، نه حدس و گمان
مدلهای استاندارد زبانهای بزرگ اغلب با APIهای مختص دامنه مشکل دارند، زیرا کاملاً به دادههای آموزشی عمومی متکی هستند که با انتشار نسخههای جدید API به سرعت منسوخ میشوند.
دستیار توسعهدهنده API گوگل ادز این مشکل را با ترکیب قوانین معماری API گوگل ادز تعبیهشده با بازرسی پویا و محلی طرحواره Protobuf حل میکند:
- اعتبارسنجی قطعی: به جای تکیه بر حدسهای تکراری LLM در چندین رفت و برگشت، دستیار یک خط لوله اعتبارسنجی محلی ۴ مرحلهای را اجرا میکند که سازگاری فیلد، روابط منابع، قوانین عدم نمایش و تقسیمبندی تاریخ را در یک مرحله تأیید میکند.
- جستجوی دقیق طرحواره بر اساس نسخه: این ابزار تعاریف منابع، انواع دادهها و مقادیر شمارشی Protobuf را مستقیماً از طرحوارههای رسمی API برای نسخه فعال API بررسی میکند و از پرسوجوهای تکراری فراداده از راه دور جلوگیری میکند.
- پایهگذاری رسمی کتابخانه کلاینت: تولید کد مستقیماً در کتابخانههای رسمی کلاینت گوگل ادز در پایتون، جاوا، PHP، داتنت و روبی پایهگذاری شده است.
قیاس: آزمایشگاه تخصصی تحقیقاتی و تشخیصی
دستیار را به عنوان یک آزمایشگاه تحقیقاتی پیشرفته برای یک جراح در نظر بگیرید.
- جراح (توسعهدهنده): شما دقیقاً میدانید چه عملیاتی باید انجام شود (برای مثال، «من باید عملکرد PMax را تجزیه و تحلیل کنم»).
- تجهیزات آزمایشگاهی (API): اینها ابزارهای قدرتمندی هستند که برای انجام جراحی مورد نیازند، اما پیچیده هستند و نیاز به کالیبراسیون دقیق دارند.
- دستیار آزمایشگاه (این ابزار): قبل از اینکه بیمار را لمس کنید، دستیار آزمایشگاه از مهارتهای تخصصی و دستورات داخلی برای موارد زیر استفاده میکند:
- راهنماها را بررسی کنید: جدیدترین پروتکلهای API را به طور خودکار تأیید میکند و ساختارهای منابع را در لحظه بررسی میکند (
inspect_object//inspect-object). - ابزارها را پیشآزمون کنید: با استفاده از اعتبارسنجی زنده API (
validate_gaql//validate-gaql) اجراهای آزمایشی قطعی روی کوئریهای شما انجام میدهد تا خطاها را قبل از وقوع شناسایی کند. - استریل کردن محیط: کد شما را با استفاده از خطوط لولهی linter دقیق (
rufflinting) قالببندی و تمیز میکند تا باعث ایجاد خطاهای سیستمی نشود. - نظارت بر موارد حیاتی: استثنائات API را زیر نظر دارد و گردشهای کاری تشخیصی پیشرفتهای را برای عملیات پیچیدهای مانند تبدیلهای آفلاین (
troubleshoot_conversions//troubleshoot-conversions) اجرا میکند. - توضیح مفاهیم: مفاهیم پیچیده را به زبان روزمره و با استفاده از قیاسهای دنیای واقعی توضیح میدهد (
/explain،/step-by-step،/assistant-tutorial).
- راهنماها را بررسی کنید: جدیدترین پروتکلهای API را به طور خودکار تأیید میکند و ساختارهای منابع را در لحظه بررسی میکند (
اتصال متقابل: پل «ایمنی در اولویت»
دستیار به عنوان پلی عمل میکند که چهار «جهان» مجزا را در پروژه شما به هم متصل میکند و توسط قراردادهای کنترلی ( AGENTS.md / CLAUDE.md ) اداره میشود:
- زمینه کاربر: به اهداف سطح بالای شما گوش میدهد و آنها را به یک استراتژی فنی تبدیل میکند.
- فضای کاری محلی: این فضا در دایرکتوری پروژه شما «چشم و دست» دارد. میتواند کد موجود را بخواند و کد جدید را برای استفاده بعدی بنویسد و در عین حال ایزوله بودن را به طور دقیق حفظ کند.
- API گوگل ادز: این API به API زنده متصل میشود تا گزارشهای فقط خواندنی را اجرا کند و کوئریها را روی حساب شما آزمایش کند. برای اعتبارسنجی فوری فیلدها، طرحوارههای محلی Protobuf را مستقیماً بررسی میکند.
- دروازهبانان ایمنی: این سیستم ذاتاً باید از پروتکلهای سختگیرانه پیروی کند. اگر اسکریپتی lint نشده باشد، به شما اجازه اجرا نمیدهد و اگر بررسی اعتبارسنجی برنامهنویسی را با موفقیت پشت سر نگذاشته باشد، به شما اجازه ارسال کوئری را نمیدهد.
کاری که دستیار واقعاً انجام میدهد
به عبارت ساده، دستیار، محافظ و شتابدهندهی شماست.
- از اشتباهات جلوگیری میکند: کد و کوئریها را قبل از اجرا با طرحهای فعال API اعتبارسنجی میکند و خطاهای نحوی و سازگاری را قبل از رسیدن به API زنده متوقف میکند.
- نقشه را میداند: جغرافیای API تبلیغات گوگل را درک میکند - اینکه دادهها کجا هستند و چگونه میتوان به طور موثر از آنها پرسوجو کرد.
- این ابزار کارهای خستهکننده را خودکار میکند: کد کتابخانه کلاینت را به صورت تکراری مینویسد، گزارشها را در جداول ترمینال تمیز قالببندی میکند و لولهکشی کتابخانه کلاینت را مدیریت میکند.
- این ابزار، گردشهای کاری پیچیده را عیبیابی میکند: عیبیابیهای عمیقی را روی آپلودهای تبدیل آفلاین انجام میدهد، سلسله مراتب حسابهای MCC را حل میکند و ساختارهای پیچیده کمپین مانند فیلترهای فهرست Performance Max و استثنائات URL را پیکربندی میکند.
- این برنامه گزارشهای موردی و زنده را پخش میکند: دادههای عملکرد را به زبان ساده درخواست کنید، و دستیار، پرسوجوهای GAQL را مستقیماً در حساب شما ایجاد، اعتبارسنجی و اجرا میکند، نتایج قالببندی شده را به ترمینال شما پخش میکند یا آنها را به CSV صادر میکند.
- بهروز میماند: با بررسی طرحها و مستندات محلی Protobuf برای یافتن نسخه فعال API، به شما کمک میکند از فیلدهای منسوخشده و قوانین قدیمی اجتناب کنید.
دستیار توسعهدهنده API گوگل ادز، کشمکش «توسعهدهنده در مقابل API» را به همکاری «توسعهدهنده + هوش مصنوعی» تبدیل میکند که کدی ایمن، اصطلاحی و از نظر معماری بینقص تولید میکند.
معماری و عملکرد (نسخه ۴.۰.۰)
نسخه ۴.۰.۰، دستیار را از یک پروژه مستقل به یک معماری افزونهای مدرن و جهانی منتقل میکند:
- سربار صفر برای دیمن: دستورات Skills و Diagnostic به صورت موقت و تنها در صورت فراخوانی به عنوان فرآیندهای فرزند سبک اجرا میشوند و در حالت بیکاری، میزان استفاده از منابع سیستم را به صفر میرسانند.
- افشای تدریجی متن: قوانین و طرحوارهها فقط در صورت نیاز و زمانی که به وظیفه فعال شما مربوط باشند، بارگذاری میشوند و به طور قابل توجهی مصرف توکن و تأخیر اعلان را کاهش میدهند.
- کاهش ورودی/خروجی دیسک: حذف فایلهای SDK غیرضروری از درخت افزونهها، مانع از اسکن دهها هزار فایل بلااستفاده توسط ایندکسکنندههای IDE، لینترها و مشاهدهگرهای فایل میشود.
- پشتیبانی از میزبان چند پلتفرمی: به طور یکپارچه در محیطهای Google Antigravity و Claude Code با اسکریپتهای نصب یکپارچه در لینوکس، macOS و ویندوز کار میکند.
مراحل بعدی
- دستیار توسعهدهنده API گوگل ادز را نصب و پیکربندی کنید
- درباره مهارتهای نماینده API گوگل ادز اطلاعات کسب کنید
- درباره سرور MCP API گوگل ادز اطلاعات کسب کنید