مهارت‌های عامل Google Ads API ماژول‌های قابل‌حمل و مستقل از دانش، دستورالعمل‌ها، و گردش‌های کاری مختص Google Ads API هستند. مهارت‌های عامل Google Ads API با دستیارهای هوش مصنوعی که از استاندارد باز Agent Skills پشتیبانی می‌کنند، ازجمله Google Antigravity و Claude Code، کار می‌کنند.
این مهارت‌های عامل برای کمک به دستیاران هوش مصنوعی طراحی شده است تا روش‌های مطلوب «میانای برنامه‌سازی کاربردی Google Ads» را درک کنند، ابزارها را پیکربندی کنند، و جریان‌های کاری را با دقت بالاتر و هزینه کمتر واحد پول اجرا کنند. برای مشاهده فهرست مهارت‌های دردسترس، مهارت‌های دردسترس را ببینید.
شروع کنید
مهارت‌های عامل مناسب برای محیط توسعه‌تان را نصب کنید.
نصب مهارت‌های عامل Google Ads API
در بیشتر موارد، مهارت‌های عامل Google Ads API را می‌توان در ویرایشگر دلخواهتان با یک فرمان نصب کرد:
Antigravity
مهارت‌های عامل Google Ads API به‌عنوان یکی از بسته‌های ادغام ساخت با Google برای Antigravity ارائه می‌شود. می‌توانید این بسته را برای دسترسی در سطح جهانی در دو نقطه فعال کنید:
- درطول آماده‌سازی: چارگوش انتخاب را برای پشته Google Ads API انتخاب کنید.
- در «تنظیمات»:
- به تنظیمات > سفارشی‌سازی‌ها بروید.
- در بخش ساختن با افزایه‌های Google، روی سفارشی‌سازی کلیک کنید، سپس برای یکپارچه‌سازی Google Ads API روی بارگیری کلیک کنید.
اگر دسترسی در سطح پروژه را ترجیح می‌دهید، فرمان زیر را در دایرکتوری پروژه‌تان اجرا کنید:
npx skills add google/skills/skills/ads --agent=antigravity
کد Claude
npx skills add google/skills/skills/ads --agent=claude-code
Codex
npx skills add google/skills/skills/ads --agent=codex
مکان‌نما
می‌توانید مهارت‌های عامل Google Ads API را مستقیماً با افزودن نقطه پایانی مخزن GitHub مهارت (برای مثال، https://github.com/google/skills) در تنظیمات ویرایشگرتان در بخش قوانین سفارشی نصب کنید. برای جزئیات بیشتر،
اسناد Cursor درباره نصب مهارت‌ها از GitHub را ببینید.
همچنین می‌توانید مهارت‌ها را بااستفاده از npx نصب کنید (به Node.js نیاز دارد):
npx skills add google/skills/skills/ads --agent=cursor
عامل‌های دیگر
برای سایر دستیارهای هوش مصنوعی که از استاندارد باز «مهارت‌های عامل» پشتیبانی می‌کنند، می‌توانید
مهارت‌ها را بااستفاده از npx نصب کنید (به Node.js نیاز دارد):
npx skills add google/skills/skills/ads
به‌روزرسانی مهارت‌های عامل Google Ads API
با اجرای فرمان
update می‌توانید همه به‌روزرسانی‌های دردسترس را دریافت کنید و مهارت‌های قدیمی را پاک‌سازی کنید:
Antigravity
ادغام‌های فعال‌شده ازطریق ساخت با Google به‌طور خودکار توسط ویرایشگر مدیریت و به‌روزرسانی می‌شوند.
اگر مهارت‌های عامل را بااستفاده از فرمان npx نصب کرده‌اید، می‌توانید با اجرای فرمان update، همه به‌روزرسانی‌های دردسترس را دریافت کنید:
npx skills update --all
کد Claude
npx skills update --all
Codex
npx skills update --all
مکان‌نما
npx skills update --all
عامل‌های دیگر
برای سایر دستیارهای هوش مصنوعی که از استاندارد باز «مهارت‌های عامل» پشتیبانی می‌کنند، می‌توانید
همه مهارت‌های فعال را بااستفاده از npx به‌روز کنید:
npx skills update --all
استفاده از مهارت‌های عامل Google Ads API
دستیاران هوش مصنوعی طوری طراحی شده‌اند که هرگاه تشخیص دهند شرح مهارتی با درخواست کنونی شما مطابقت دارد، به‌طور خودکار از آن مهارت استفاده کنند. مهارت‌های نصب‌شده به‌صورت سراسری در پروژه‌های نامرتبط غیرفعال می‌مانند، مگراینکه بافت پیام‌واره شما با تکالیف Google Ads API مطابقت داشته باشد.
همچنین می‌توان با تایپ کردن / در گپ نماینده و جستجوی نام مهارت، مهارت‌ها را به‌صورت دستی فراخوانی کرد.
عناصر اصلی مهارت
هر مهارت عامل یک بسته تخصصی است که مؤلفه‌های زیر را برای دستیار هوش مصنوعی فراهم می‌کند:
- دستورالعمل‌های تخصصی: دستورالعمل‌های دقیق پیام‌واره که به پنجره بافت تزریق شده‌اند تا دستیار را در تولید پُرسمان‌های GAQL، پیکربندی اطلاعات کاربری OAuth، و رسیدگی به کدهای خطای رایج راهنمایی کنند.
- روال‌های مطلوب: عملکرد استاندارد، امنیت، و یکپارچه‌سازی توصیه‌هایی که تیم Google Ads API DevRel تعریف کرده است.
- دستورگان‌های خودکارسازی: دستورگان‌های قابل‌اجرا (مثلاً برای اعتبارسنجی محیط یا راه‌اندازی فضای کاری) که در بسته‌های مهارت گنجانده شده‌اند تا تکالیف را به‌صورت محلی اجرا کنند.
مزایای استفاده از مهارت‌ها
مهارت‌های عامل قابلیت‌های دستیار را با دانش تخصصی درصورت درخواست گسترش می‌دهند، بدون اینکه بار اضافی بار کردن دستورالعمل‌های حجیم در هر مکالمه وجود داشته باشد.
کاهش هزینه‌های کد
یکپارچه‌سازی‌های هوش مصنوعی مرسوم اغلب حجم عظیمی از اسناد را ازقبل بار می‌کنند که باعث مصرف قابل‌توجهی از نشان‌ها و افزایش هزینه‌های جلسه می‌شود. مهارت‌های عامل از شفاف‌سازی تدریجی برای به‌حداقل رساندن این سربار استفاده می‌کنند:
- دستیار هوش مصنوعی در ابتدا فقط نام و شرح مهارت را بررسی می‌کند تا ببیند آیا با درخواست شما مرتبط است یا نه.
- دستورالعمل‌ها و مراجع کامل مهارت فقط زمانی به پنجره بافت فعال اضافه می‌شوند که دستیار تشخیص دهد برای تکلیف خاص شما ضروری هستند، که این کار باعث صرفه‌جویی در فضای بافت می‌شود.
پیاده‌سازی با راهنمایی هوش مصنوعی
به‌جای جستجوی دستی در اسناد، می‌توانید قصدتان را به زبان طبیعی شرح دهید. مهارت‌ها دستیار هوشواره‌ای شما را برای انجام تکالیفی مانند موارد زیر راهنمایی می‌کنند:
- یک پُرسمان GAQL برای بازیابی سنجه‌های عملکرد پویش از حسابم تولید کن.
- بااستفاده از کتابخانه‌های مشتری، یک اسکریپت Python برای ایجاد پویش جدید بنویسید.
- بازیابی تبدیل‌های پویش و داده‌های تشخیص خرابی بااستفاده از Google Ads API.
برای دیدن فهرست کامل مهارت‌های دردسترس، به مهارت‌های دردسترس مراجعه کنید.
استفاده از مهارت‌ها در کنار سرور MCP «میانای برنامه‌سازی کاربردی Google Ads»
مهارت‌های عامل برای تکمیل سرور پروتکل بافتار مدل (MCP) Google Ads API طراحی شده‌اند:
- سرور Google Ads API MCP: برای گردش‌های کار توسعه با کمک هوش مصنوعی طراحی شده است و به دستیارهای هوش مصنوعی امکان می‌دهد به‌صورت برنامه‌ریزی‌شده با منابع Google Ads API، پویش‌ها، و سنجه‌های شما تعامل داشته باشند.
- مهارت‌های عامل Google Ads API: دستورالعمل‌های پیام‌واره و رویه‌های توصیه‌شده‌ای ارائه می‌دهد که دستیار را برای انجام تکالیف ازطریق شفاف‌سازی تدریجی با بهره‌وری از نشان راهنمایی می‌کند. این دستورالعمل‌ها به عامل می‌گویند که چگونه از ابزارهایی مثل سرور MCP و کتابخانه‌های کارخواه به‌طور مؤثر استفاده کند.
مهارت‌های دردسترس
تیم Google Ads API مجموعه‌ای از مهارت‌ها را برای ساختن با Google Ads API ارائه می‌دهد:
| مهارت | شرح |
|---|---|
google-ads-api-account-diagnostics |
بااستفاده از سرور Google Ads API MCP، مشکلات عملکرد حساب Google Ads را مانند ازدست رفتن تبدیل، حجم مشتری بالقوه پایین، و سهم ظهور ازدست‌رفته به‌دلیل رتبه آگهی، پیشنهاد قیمت، یا بودجه تشخیص می‌دهد. |
google-ads-api-mcp-setup |
در راه‌اندازی و پیکربندی سرور «پروتکل بافتار مدل» (MCP) Google Ads API کمک می‌کند و اصالت‌سنجی و پیکربندی را در محیط‌های محلی ساده می‌کند. |
google-ads-api-quickstart |
شما را در راه‌اندازی محیط توسعه‌دهنده، پیکربندی اطلاعات اعتباری، و برقراری اولین تماس میانای برنامه‌سازی کاربردی با Google Ads API راهنمایی می‌کند. |
مراحل بعدی
- با نحوه استفاده از مهارت‌های کارگزار با Claude Code آشنا شوید
- با نحوه استفاده از مهارت‌های نماینده با Antigravity آشنا شوید