معرفی Google Ads API Developer Assistant نسخه ۲.۰

پنجشنبه، ۲۶ فوریه ۲۰۲۶

این به‌روزرسانی بزرگ، دستیار را از یک ابزار قدرتمند تولید کد به یک شریک فعال در عیب‌یابی و خودکارسازی برای توسعه‌دهندگان Google Ads تبدیل می‌کند. از زمان انتشار نسخه ۱.۶.۰، به بازخوردهای شما گوش داده‌ایم و روی چالش‌برانگیزترین بخش‌های توسعه میانای برنامه‌سازی کاربردی تمرکز کرده‌ایم: تشخیص، سازگاری، و راه‌اندازی.

چه چیزهایی در نسخه ۲.۰ جدید است؟

۱. نصب و نگهداری ساده‌تر

راه‌اندازی محیط توسعه چندزبانه نباید کار سختی باشد.

  • راه‌اندازی با یک فرمان: از پرچم جدید --install-deps با install.sh یا install.ps1 استفاده کنید تا وابستگی‌های pip،‏ composer، و bundler را یک‌باره مدیریت کنید.
  • ساختار دایرکتوری یکپارچه: همه کدهای تولیدشده، فایل‌های CSV صادرشده، و گزارش‌های تشخیص خرابی شما اکنون تحت یک دایرکتوری saved/ با زیردایرکتوری‌هایی برای هر نوع خروجی سازمان‌دهی شده‌اند.
  • به‌روزرسانی با یک فرمان: وقتی نسخه جدیدی از API و کتابخانه‌های کارخواه منتشر می‌شود، برای کار با جدیدترین نسخه باید update.sh را اجرا کنید. همچنین می‌توانید از update.sh برای افزودن کتابخانه‌های مشتری بیشتر به بافت خود استفاده کنید.

۲. عیب‌یابی تبدیل عامل‌گرا

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

در نسخه ۲.۰، مجموعه اختصاصی عیب‌یابی و تشخیص خرابی تبدیل را معرفی کرده‌ایم.

  • متن جدید: api_examples/collect_conversions_troubleshooting_data.py
  • فرمان جدید: /conversions_support_data

این اسکریپت گزارش‌های استاندارد را برای عیب‌یابی تبدیل‌ها اجرا می‌کند و زمینه‌ای را برای «دستیار» فراهم می‌کند تا مشکلات شما را عیب‌یابی کند.

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

۳. ساخته‌شده برای جدیدترین میانای برنامه‌سازی کاربردی (نسخه ۲۳)

نسخه ۲.۰ به‌طور کامل از Google Ads API v23 پشتیبانی می‌کند. همه نمونه‌های تعاملی ما به‌روز شده‌اند و بافت داخلی «دستیار» اکنون برای جدیدترین منابع و فیلدها بهینه‌سازی شده است تا مطمئن شویم کدی که تولید می‌کنید آماده تولید است.

۴. خودکارسازی یکپارچه با قلاب‌های جلسه

قلاب‌های SessionStart و SessionEnd را اضافه کرده‌ایم تا گردش کارتان واقعاً بدون اصطکاک باشد.

  • پیکربندی خودکار: اکنون «دستیار» می‌تواند در شروع جلسه، فایل پیکربندی شما را به‌طور خودکار در دایرکتوری $HOME پیدا کند. این دستور، فایل را در پیکربندی زیرشاخه در فهرست پروژه شما کپی می‌کند. Python زبان ترجیحی Gemini برای پُرسمان API است. بنابراین، اگر از زبان دیگری استفاده می‌کنید، فایل پیکربندی شما را می‌خواند و یک google-ads.yaml موقت در پیکربندی برای پُرسمان‌هایش ایجاد می‌کند، اما همچنان به زبان ترجیحی شما در کد پاسخ می‌دهد.
  • پاک‌سازی خودکار: پیکربندی‌های موقت هنگام خروج شما به‌طور ایمن پاک می‌شوند تا فضای کاری‌تان تمیز و اطلاعات کاربری‌تان ایمن بماند.

۵. اعتبارسنجی هوشمندتر GAQL

ساختن پُرسمان‌های پیچیده GAQL از همیشه آسان‌تر شده است. GEMINI.md و conversions/GEMINI.md را با قوانین اعتبارسنجی دقیق برای جدیدترین موارد حاشیه‌ای میانای برنامه‌سازی کاربردی به‌روز کرده‌ایم، ازجمله بهبود مدیریت بخش‌های تاریخ و الزامات محدوده محدود. اکنون «دستیار» خطاهای منطقی را پیش‌از اجرای پُرسمان شناسایی می‌کند.

‫۶. مهارت‌ها

«مهارت» را به‌عنوان یک افزونه کوچک یا «طرح رفتار» درنظر بگیرید. درحالی‌که بافت کلی (مثل فایل GEMINI.md شما) اطلاعات پس‌زمینه را ارائه می‌دهد، «مهارت» فقط زمانی در مغز هوش مصنوعی «بار می‌شود» که به‌طور خاص نیاز به انجام یک تکلیف پیچیده و رویه‌ای داشته باشد، مثل دریافت نسخه فعلی این افزونه. شما «مهارت» را مستقیماً اجرا نمی‌کنید. ‫Gemini تصمیم می‌گیرد که چه زمانی به آن نیاز دارد.

اگرچه این ویژگی هنوز آزمایشی است، اما ما یکی از آن‌ها را در این نسخه گنجانده‌ایم تا استفاده ما از قلاب‌ها برای مقداردهی اولیه و پاک‌سازی جلسه را تکمیل کند.

چرا باید ارتقا دهید؟

جهش از نسخه ۱.۶.۰ به نسخه ۲.۰.۰ فقط به‌خاطر ویژگی‌های جدید نیست، بلکه به‌خاطر قابلیت اطمینان است. نسخه ۲.۰ با ادغام دانش عمیق میانای برنامه‌سازی کاربردی با ابزارهای عیب‌یابی خودکار، چرخه «آزمون و خطا» را که اغلب ادغام میانای برنامه‌سازی کاربردی را کند می‌کند کاهش می‌دهد.

چه درحال اشکال‌زدایی بارگذاری‌های تبدیل باشید یا درحال ساختن خطوط لوله گزارش‌دهی پیچیده، نسخه ۲.۰ ابزارهایی را دراختیارتان قرار می‌دهد تا سریع‌تر و با اطمینان بیشتری کار کنید.

شروع کردن

اولین نصب

ارتقا دادن از نسخه قبلی

  • هرگونه کد سفارشی را از saved_code/ و saved_csv/ در مکانی امن کپی کنید.
  • با حذف کردن فهرست راهنمای پروژه و همه زیرفهرست‌های راهنما و فایل‌ها، کلون محلی Google Ads API Developer Assistant را حذف کنید.
  • git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  • در فهرست راهنمای پروژه، install.sh یا install.ps1 را اجرا کنید تا افزونه و کتابخانه‌های کارخواه نصب شود.

Bob Hancock، تیم Google Ads API

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