השקת גרסה 3.0.0 של Google Ads API Developer Assistant

יום רביעי, 10 ביוני 2026

אנחנו שמחים להודיע על השקת גרסה 3.0.0 של Google Ads API Developer Assistant. הגרסה הזו היא אבן דרך משמעותית בהתפתחות של Assistant, והיא מתמקדת במודרניזציה של הארכיטקטורה, בשיפור האמינות ובעיצוב מודולרי יותר.

בגרסה הזו, אנחנו מעבירים את Assistant למסגרת הסוכנים של Google Antigravity ועוברים לארכיטקטורה מבוססת-מיומנויות. השינויים האלה הופכים את Assistant ליציבה יותר, קלה יותר לתחזוקה ומפחיתים את השימוש בטוקנים.

מה חדש בגרסה 3.0.0?

1. מבוסס על מסגרת Antigravity

העוזר הדיגיטלי למפתחים של Google Ads API הועבר מ-gemini-cli למסגרת הסוכנים של Antigravity (גרסה 3.0.0). השדרוג הזה של המסגרת הבסיסית מספק סביבת הרצה מובנית ואמינה יותר. בנוסף, מבנה הספרייה והקבצים של הפרויקט עודכן כך שיהיה מוכן לחלוטין ל-Antigravity.

התמיכה ב-gemini-cli תסתיים ב-18 ביוני 2026, כפי שמפורט בהודעה הזו בבלוג של Google.

2. ארכיטקטורה מודולרית שמבוססת על מיומנויות

העברנו את היכולות העיקריות של Assistant אל מיומנויות. במקום להסתמך על הוראות כלליות ולא מובנות בקובץ הקשר, Assistant טוענת עכשיו באופן דינמי ספריות כלים מיוחדות שנבדקו (מיומנויות) לפי הצורך. כך אפשר לצמצם משמעותית את "ההזיות" ולוודא שהמשימות מבוצעות באמצעות נהלים מדויקים ומאומתים.

העדכונים העיקריים במעבר המודולרי הזה כוללים:

  • אימות GAQL‏ (validate_gaql): הועבר למיומנות ייעודית. הוא כולל עכשיו בדיקות משופרות של שאילתות סטטיות לפלחי תאריכים, מסננים של יום אחד (click_view) וגבולות (change_status).
  • פתרון בעיות שקשורות להמרות (troubleshoot_conversions): מחליף את conversions_support_package הישן. הוא מאחד את כל הסקריפטים והבדיקות של סיכום ההעלאות ופתרון הבעיות בהמרות לספריית סקילים אחת.
  • פקודות מובנות (explain ו-step_by_step): הומרו למיומנויות כדי לאכוף פריסות עקביות ומובנות להסברים.
  • ‫מיפוי חשבונות חדש (get_cids_under_mcc): מיומנות חדשה לאחזור כל חשבונות הצאצא בחשבון ניהול (MCC).
  • בדיקת אובייקטים חדשה (inspect_object): מיומנות חדשה לחיפוש דינמי של הודעות Protobuf ו-Enums בזמן אמת, כדי להבטיח ש-Assistant תמיד תשתמש במבנים הנכונים.
  • מסנן חדש של כרטיסי מוצר בקמפיינים למיקסום הביצועים (pmax_listing_filter): מיומנות חדשה שמאפשרת לבצע שינויים סטנדרטיים בעץ ההחרגות של דפי אינטרנט בקבוצות של כרטיסי מוצר בקמפיינים למיקסום הביצועים.

3. עקביות וקפדנות משופרות

הוספנו כללים ודרישות מחמירים יותר כדי להבטיח איכות גבוהה של יצירת קוד ואימות שאילתות:

  • גרסאות API מפורשות: סקילים קריטיים כמו get_cids_under_mcc,‏ validate_gaql ו-troubleshoot_conversions דורשים עכשיו ארגומנט api_version מפורש, כדי למנוע אי-בהירות.
  • כללי GAQL מחמירים:
    • הוספנו כלל ל-AGENTS.md כדי למנוע שימוש בפונקציות צבירה של SQL (כמו SUM,‏ COUNT ו-AVG) בשאילתות GAQL, כי הן לא נתמכות.
    • הוספנו כלל שבודק קודם את הערות הגרסה באתר המפתחים של Google Ads API כדי לוודא שה-Assistant משתמשת בגרסה העדכנית ביותר של התיעוד.
    • הגדרה יעילה יותר: AGENTS.md הוגדר בצורה יעילה יותר, וכתוצאה מכך חלון ההקשר הראשוני קטן יותר. הסרנו את התיעוד הכפול בנושא המרות, והוספנו במקומו מידע על מיומנויות פרוגרמטיות.

4. שיפורים בחוויית המפתחים (DX)

ביצענו כמה שיפורים כדי להפוך את תהליך הפיתוח למהיר וחלק יותר:

  • סביבה וירטואלית קבועה (.venv): הסביבה הווירטואלית לא נמחקת יותר בסוף הסשן. בזמן ההפעלה, Assistant בודקת את גרסת ה-Python של המערכת. היא בונה מחדש את .venv רק אם יש גרסה חדשה יותר של Python.
  • שמירה חכמה במטמון של גרסת ה-API: Assistant שומרת עכשיו במטמון את הגרסה הנוכחית של Google Ads API עם TTL של 19 שעות, וכך מקצרת את זמן ההפעלה על ידי מניעת בדיקות רשת מיותרות.
  • ניפוי באגים משופר עם יומנים קבועים: הודעות ביומן כוללות עכשיו חותמות תאריך ושעה. קובץ היומן נכתב בספרייה .agents/ והוא לא מתאפס בכל הפעלה, כדי לשמור את ההיסטוריה לצורך פתרון בעיות.

למה כדאי לשדרג?

השדרוג לגרסה 3.0.0 מתמקד בעיקר באמינות ובמבנה. המעבר למסגרת Antigravity ופיצול התכונות למיומנויות נפרדות הפכו את Assistant ליותר צפויה ויעילה מבחינת משאבים.

אם אתם רוצים שההפעלה תהיה מהירה יותר, שהאימות של GAQL יהיה אמין יותר ושתהליך פתרון הבעיות יהיה יעיל יותר, מומלץ לשדרג לגרסה 3.0.0.

איך מתחילים

התקנה ראשונה

  1. מתקינים את Antigravity CLI: פועלים לפי ההוראות בכתובת https://antigravity.google/.
  2. שכפול ה-Assistant: 
    git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  3. מריצים את סקריפט ההתקנה:
    • ‫Linux/macOS: מריצים את ./install.sh (ברירת המחדל היא תמיכה ב-Python, משתמשים בדגלים כמו --php או --ruby לשפות אחרות).
    • Windows: פותחים את PowerShell ומריצים את .\install.ps1.

שדרוג מגרסה 2.x

  1. מעתיקים קוד או נתונים בהתאמה אישית מ-saved/ למיקום מאובטח מחוץ לספריית הפרויקט.
  2. מוחקים את העותק המקומי של Assistant.
  3. משכפלים את המאגר:
git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  1. מריצים את סקריפט ההתקנה (install.sh או install.ps1) כדי להפעיל את סביבת Antigravity החדשה.

Bob Hancock, Google Ads API Team

תוויות: google-ads-api, release