مهارت‌های نماینده Google Ads API

مهارت‌های عامل Google Ads API، واحدهای قابل‌حمل و مستقل از دانش، دستورالعمل‌ها، و گردش‌های کاری مختص Google Ads API هستند. مهارت‌های عامل Google Ads API با دستیارهای هوش مصنوعی که از استاندارد باز Agent Skills پشتیبانی می‌کنند، ازجمله Google Antigravity و Claude Code، کار می‌کنند.

این مهارت‌های عامل برای کمک به دستیارهای هوش مصنوعی طراحی شده‌اند تا بهترین روش‌های Google Ads API را درک کنند، ابزارها را پیکربندی کنند، و گردش‌های کاری را با دقت بالاتر و هزینه کمتر توکن اجرا کنند. برای مشاهده فهرست مهارت‌های دردسترس، مهارت‌های دردسترس را ببینید.

شروع کنید

مهارت‌های عامل مناسب برای محیط توسعه نرم‌افزار خود را نصب کنید.

نصب مهارت‌های عامل Google Ads API

در بیشتر موارد، مهارت‌های عامل Google Ads API را می‌توان با یک فرمان در ویرایشگر دلخواهتان نصب کرد:

Antigravity

مهارت‌های عامل Google Ads API به‌عنوان یکی از بسته‌های ادغام ساخت با Google برای Antigravity گنجانده شده است. می‌توانید این بسته را برای دسترسی در سطح جهانی در دو نقطه فعال کنید:

  • درطول آماده‌سازی: چارگوش انتخاب را برای پشته Google Ads API انتخاب کنید.
  • در «تنظیمات»:
    1. به تنظیمات > سفارشی‌سازی‌ها بروید.
    2. در بخش ساخت با افزونه‌های Google، روی سفارشی‌سازی کلیک کنید، سپس برای ادغام Google Ads API روی بارگیری کلیک کنید.

اگر دسترسی در سطح پروژه را ترجیح می‌دهید، فرمان زیر را در فهرست راهنمای پروژه‌تان اجرا کنید:

npx skills add google/skills/skills/ads --agent=antigravity

Claude Code 

npx skills add google/skills/skills/ads --agent=claude-code

کدکس 

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 Code 

npx skills update --all

کدکس 

npx skills update --all

مکان‌نما 

npx skills update --all

عامل‌های دیگر

برای سایر دستیارهای هوش مصنوعی که از استاندارد باز «مهارت‌های عامل» پشتیبانی می‌کنند، می‌توانید همه مهارت‌های فعال را بااستفاده از npx به‌روز کنید:

npx skills update --all

استفاده از مهارت‌های عامل Google Ads API

دستیارهای هوش مصنوعی به‌گونه‌ای طراحی شده‌اند که هرگاه تشخیص دهند شرح مهارتی با درخواست فعلی شما مطابقت دارد، به‌طور خودکار از آن مهارت استفاده کنند. مهارت‌های نصب‌شده به‌صورت سراسری در پروژه‌های نامرتبط غیرفعال می‌مانند، مگراینکه بافت پیام‌واره شما با تکالیف Google Ads API مطابقت داشته باشد.

مهارت‌ها را می‌توان به‌صورت دستی نیز با تایپ کردن / در گپ نماینده و جستجوی نام مهارت فراخوانی کرد.

عناصر اصلی مهارت

هر مهارت عامل یک بسته تخصصی است که مؤلفه‌های زیر را برای دستیار هوش مصنوعی فراهم می‌کند:

  • دستورالعمل‌های تخصصی: دستورالعمل‌های پیام‌واره دقیق که به پنجره زمینه تزریق شده‌اند تا دستیار را در تولید پُرسمان‌های GAQL، پیکربندی اعتبارنامه‌های OAuth، و مدیریت کدهای خطای رایج راهنمایی کنند.
  • روال‌های مطلوب: توصیه‌های استاندارد عملکرد، امنیت، و ادغام که توسط تیم DevRel در Google Ads API تعریف شده است.
  • دستورگان‌های خودکارسازی: دستورگان‌های قابل‌اجرا (مثلاً برای اعتبارسنجی محیط یا راه‌اندازی فضای کاری) که در بسته‌های مهارت گنجانده شده‌اند تا تکالیف را به‌صورت محلی اجرا کنند.

مزایای استفاده از مهارت‌ها

مهارت‌های عامل قابلیت‌های دستیار را با دانش تخصصی درصورت درخواست گسترش می‌دهند، بدون اینکه بار اضافی بارگیری دستورالعمل‌های حجیم در هر مکالمه وجود داشته باشد.

کاهش هزینه توکن

ادغام‌های هوش مصنوعی مرسوم اغلب حجم عظیمی از اسناد را ازقبل بار می‌کنند که باعث مصرف تعداد زیادی از نشان‌ها و افزایش هزینه‌های جلسه می‌شود. مهارت‌های عامل از شفاف‌سازی تدریجی برای به‌حداقل رساندن این سربار استفاده می‌کنند:

  • دستیار هوش مصنوعی در ابتدا فقط نام و شرح مهارت را بررسی می‌کند تا ببیند آیا به درخواست شما مربوط است یا نه.
  • دستورالعمل‌ها و مراجع کامل مهارت فقط زمانی به پنجره زمینه فعال اضافه می‌شوند که دستیار تشخیص دهد برای تکلیف خاص شما ضروری هستند، که این کار باعث صرفه‌جویی در فضای زمینه می‌شود.

پیاده‌سازی با راهنمایی هوش مصنوعی

به‌جای جستجوی دستی در اسناد، می‌توانید قصدتان را به زبان طبیعی شرح دهید. مهارت‌ها دستیار هوش مصنوعی شما را برای انجام کارهایی مثل موارد زیر راهنمایی می‌کنند:

  • یک پُرسمان 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 بااستفاده از سرور MCP در Google Ads API، مشکلات عملکرد حساب Google Ads را تشخیص می‌دهد، ازجمله ازدست رفتن تبدیل، حجم کم مشتریان بالقوه، و ازدست رفتن سهم ظهور به‌دلیل رتبه آگهی، قیمت‌های پیشنهادی، یا بودجه‌ها.
google-ads-api-mcp-setup به راه‌اندازی و پیکربندی سرور «پروتکل بافتار مدل» (MCP) در Google Ads API کمک می‌کند و اصالت‌سنجی و پیکربندی را در محیط‌های محلی ساده می‌کند.
google-ads-api-quickstart شما را در راه‌اندازی محیط توسعه‌دهنده، پیکربندی اطلاعات کاربری، و برقراری اولین تماس API با Google Ads API راهنمایی می‌کند.

مراحل بعدی