معرفی Google Ads API Developer Assistant نسخه ۱.۰: تعامل با میانای برنامه‌سازی کاربردی بااستفاده از زبان طبیعی

چهارشنبه، ۱۰ دسامبر ۲۰۲۵

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

چه کارهایی می‌تواند انجام دهد؟

‫Google Ads API Developer Assistant (v1.0) با چندین ویژگی کلیدی Gemini CLI را بهبود می‌بخشد:

  1. پرسش و پاسخ به زبان طبیعی: درباره Google Ads API سؤالی دارید؟ کافی است بپرسید!
    • «انواع پویش‌های دردسترس چیست؟»
    • «درباره گزارش‌دهی برای پویش‌های «بیشینه‌سازی عملکرد» به من بگو.»
    • «چگونه در GAQL براساس تاریخ فیلتر کنم؟»
  2. تولید کد از زبان طبیعی: داده‌های موردنیازتان را شرح دهید و دستیار بااستفاده از کتابخانه کارخواه google-ads-python به‌عنوان بافت، «زبان پُرسمان Google Ads» (GAQL) و کد Python قابل‌اجرا را تولید می‌کند تا کد با روال‌های مطلوب مطابقت داشته باشد.
    • «پویش‌هایی را که بیشترین تبدیل را در ۳۰ روز گذشته داشته‌اند به من نشان بده.»
    • «همه گروه‌های آگهی را برای مشتری «‎123-456-7890» دریافت کنید.»
    • «آگهی‌های تأییدنشده را در همه پویش‌ها پیدا کنید.»
    • کد تولیدشده به‌طور خودکار در دایرکتوری saved_code/ ذخیره می‌شود.
  3. اجرای مستقیم میانای برنامه‌سازی کاربردی: دستورگان‌های Python تولیدشده را مستقیماً از خط فرمان اجرا کنید. دستیار فراخوانی‌های میانای برنامه‌سازی کاربردی فقط خواندنی را اجرا می‌کند و نتایج را نمایش می‌دهد، که اغلب به‌صورت جدول‌های مرتب در پایانه شما قالب‌بندی شده‌اند.
  4. صادر کردن CSV: می‌خواهید داده‌هایتان را ذخیره کنید؟ می‌توانید به‌راحتی نتایج جدولی را از تماس‌های API به فایل CSV صادر کنید. کافی است بپرسید:
    • «نتایج را در فایل CSV ذخیره کن»
    • فایل‌ها در فهرست راهنمای saved_csv/ ذخیره می‌شوند.

روش کار؟

این افزونه از توانایی Gemini CLI برای استفاده از بافت فایل‌ها و تنظیمات GEMINI.md در .gemini/settings.json بهره می‌برد. با پیکربندی دستیار با مسیرهای کلون کتابخانه google-ads-python محلی و دایرکتوری‌های نمونه، این دستیار تولید کد مرتبط و دقیق را ارائه می‌دهد.

شروع به کار

آنچه برای راه‌اندازی و اجرا نیاز دارید:
پیش‌نیازها:

  • آشنایی با مفاهیم Google Ads API و اصالت‌سنجی.
  • کد توسعه‌دهنده Google Ads API.
  • فایل اطلاعات اعتباری google-ads.yaml پیکربندی‌شده در فهرست راهنمای خانه شما.
  • Python >= 3.10.
  • Gemini CLI نصب شده باشد.
  • نسخه محلی کتابخانه مشتری google-ads-python. (دستورگان راه‌اندازی می‌تواند این را برای شما شبیه‌سازی کند.)

لطفاً برای دستورالعمل‌های راه‌اندازی دقیق و مثال‌ها، به فایل README در مخزن GitHub مراجعه کنید.

کجا آن را پیدا کنید

«دستیار توسعه‌دهنده Google Ads API» در GitHub دردسترس است.

انجمن و پشتیبانی

توصیه می‌کنیم آن را امتحان کنید! بازخورد شما ارزشمند است و می‌توانید آن را در این نظرسنجی ارائه دهید. در کانال ads-api-ai-tools #در Discord ما به بحث بپیوندید.

لطفاً برای گزارش کردن اشکالات، پیشنهاد دادن ویژگی‌ها، یا درخواست پشتیبانی، از برگه «مشکلات GitHub» در مخزن استفاده کنید. برای اطلاع از رهنمودهای همیاری، CONTRIBUTING.md را بررسی کنید.

کدنویسی خوش بگذرد!

برچسب‌ها: google-ads-api، release