مهارت‌های نماینده API گوگل ادز

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

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

شروع کنید

مهارت‌های عامل (agent skills) مناسب برای محیط توسعه خود را نصب کنید.

مهارت‌های عامل API تبلیغات گوگل را نصب کنید

در بیشتر موارد، مهارت‌های عامل API گوگل ادز را می‌توان با یک دستور واحد در ویرایشگر دلخواه شما نصب کرد:

ضد جاذبه

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

  • در طول دوره آشنایی : کادر مربوط به مجموعه API تبلیغات گوگل (Google Ads API stack) را علامت بزنید.
  • در تنظیمات : به تنظیمات > سفارشی‌سازی‌ها بروید. در قسمت ساخت با افزونه‌های گوگل ، روی سفارشی‌سازی کلیک کنید، سپس برای دانلود ادغام API تبلیغات گوگل، روی دانلود کلیک کنید.

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

npx skills add google/skills --agent=antigravity

کلود کد 

claude plugin marketplace add google/skills
claude plugin install google-ads@skills

کدکس 

npx skills add google/skills

مکان نما

شما می‌توانید مهارت‌های عامل API گوگل ادز را مستقیماً با اضافه کردن نقطه پایانی مخزن گیت‌هاب مهارت (برای مثال، https://github.com/google/skills ) در تنظیمات ویرایشگر خود در بخش قوانین سفارشی نصب کنید. برای جزئیات بیشتر، به مستندات قوانین مکان‌نما مراجعه کنید.

سایر عوامل

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

npx skills add google/skills

مهارت‌های نماینده API تبلیغات گوگل را به‌روزرسانی کنید

شما می‌توانید با اجرای دستور update تمام به‌روزرسانی‌های موجود را دریافت کرده و مهارت‌های قدیمی را پاک کنید:

ضد جاذبه

ادغام‌های فعال‌شده از طریق Build with Google به‌طور خودکار توسط ویرایشگر مدیریت و به‌روزرسانی می‌شوند.

اگر مهارت‌های عامل را با استفاده از دستور npx نصب کرده‌اید، می‌توانید با اجرای دستور update تمام به‌روزرسانی‌های موجود را دریافت کنید:

npx skills update --all

کلود کد 

claude plugin update google-ads@skills

کدکس 

npx skills update --all

مکان نما 

npx skills update --all

سایر عوامل

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

npx skills update --all

از مهارت‌های نماینده API گوگل ادز استفاده کنید

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

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

اجزای اصلی یک مهارت

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

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

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

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

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

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

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

پیاده‌سازی هدایت‌شده توسط هوش مصنوعی

به جای جستجوی دستی در اسناد، می‌توانید هدف خود را به زبان طبیعی توصیف کنید. مهارت‌ها دستیار هوش مصنوعی شما را برای انجام وظایفی مانند موارد زیر راهنمایی می‌کنند:

  • یک کوئری GAQL ایجاد کنید تا معیارهای عملکرد کمپین را از حساب من بازیابی کند.
  • با استفاده از کتابخانه‌های کلاینت، یک اسکریپت پایتون برای ایجاد یک کمپین جدید بنویسید.
  • با استفاده از API تبلیغات گوگل، تبدیل‌های کمپین و داده‌های تشخیصی را بازیابی کنید.

برای مشاهده لیست کامل مهارت‌های موجود، به مهارت‌های موجود مراجعه کنید.

از مهارت‌ها در کنار سرور MCP API گوگل ادز استفاده کنید

مهارت‌های نماینده برای تکمیل سرور پروتکل زمینه مدل API گوگل ادز (MCP) طراحی شده‌اند:

  • سرور MCP API گوگل ادز : برای گردش‌های کاری توسعه با کمک هوش مصنوعی طراحی شده است و دستیاران هوش مصنوعی را قادر می‌سازد تا با منابع، کمپین‌ها و معیارهای API گوگل ادز شما به صورت برنامه‌نویسی شده تعامل داشته باشند.
  • مهارت‌های نماینده API تبلیغات گوگل : ارائه دستورالعمل‌های سریع و شیوه‌های توصیه‌شده که دستیار را برای انجام وظایف از طریق افشای تدریجی توکن‌ها راهنمایی می‌کند. آن‌ها به نماینده نحوه استفاده مؤثر از ابزارهایی مانند سرور MCP و کتابخانه‌های کلاینت را آموزش می‌دهند.

مهارت‌های موجود

تیم API تبلیغات گوگل مجموعه‌ای از مهارت‌ها را برای ساخت با API تبلیغات گوگل ارائه می‌دهد:

مهارت توضیحات
google-ads-api-mcp-setup به راه‌اندازی و پیکربندی سرور پروتکل زمینه مدل (MCP) API گوگل ادز کمک می‌کند و احراز هویت و پیکربندی را در محیط‌های محلی ساده می‌سازد.
google-ads-api-quickstart شما را در راه‌اندازی محیط توسعه‌دهنده، پیکربندی اعتبارنامه‌ها و برقراری اولین فراخوانی API به API تبلیغات گوگل راهنمایی می‌کند.

مراحل بعدی