הכירו את גרסה 2.0 של Google Ads API Developer Assistant

יום חמישי, 26 בפברואר 2026

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

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

1. התקנה ותחזוקה פשוטות יותר

הגדרת סביבת פיתוח בכמה שפות לא צריכה להיות מטלה.

  • הגדרה בפקודה אחת: משתמשים בדגל החדש --install-deps עם install.sh או install.ps1 כדי לטפל ביחסי התלות של pip,‏ composer ו-bundler בבת אחת.
  • מבנה ספרייה מאוחד: כל הקוד שנוצר, קובצי ה-CSV שיוצאו ודוחות האבחון מאורגנים עכשיו בספרייה אחת (saved/) עם ספריות משנה לכל סוג של פלט.
  • עדכון בפקודה אחת: כשיוצאת גרסה חדשה של ה-API ושל ספריות הלקוח, צריך להריץ את update.sh כדי לעבוד עם הגרסה העדכנית. אפשר גם להשתמש ב-update.sh כדי להוסיף עוד ספריות לקוח להקשר.

2. פתרון בעיות בהמרות באמצעות סוכן

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

בגרסה 2.0 הוספנו חבילה ייעודית של כלים לפתרון בעיות ולאבחון של המרות.

  • סקריפט חדש: api_examples/collect_conversions_troubleshooting_data.py
  • פקודה חדשה: /conversions_support_data

הסקריפט מפעיל דוחות רגילים לפתרון בעיות בהמרות ומספק הקשר ל-Assistant כדי לפתור את הבעיות.

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

3. מיועדת ל-API העדכני (גרסה 23)

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

4. אוטומציה חלקה עם Session Hooks

הוספנו הוקים של SessionStart ו-SessionEnd כדי שתהליך העבודה שלכם יהיה חלק לחלוטין.

  • הגדרה אוטומטית: בתחילת הסשן, Assistant יכולה לאתר באופן אוטומטי את קובץ התצורה בספריית $HOME. הוא מעתיק אותו לתיקיית המשנה config בספריית הפרויקט. ‫Python היא השפה המועדפת על Gemini לשליחת שאילתות ל-API. לכן, אם אתם משתמשים בשפה אחרת, הוא קורא את קובץ התצורה ויוצר קובץ google-ads.yaml זמני ב-config בשביל השאילתות שלו, אבל ממשיך להגיב בקוד של השפה המועדפת עליכם.
  • ניקוי אוטומטי: הגדרות זמניות נמחקות באופן מאובטח כשיוצאים, כדי לשמור על סביבת עבודה נקייה ועל פרטי כניסה בטוחים.

5. אימות חכם יותר של GAQL

עכשיו קל יותר מתמיד ליצור שאילתות GAQL מורכבות. עדכנו את GEMINI.md ואת conversions/GEMINI.md עם כללי אימות מחמירים למקרי קצה חדשים של API, כולל טיפול משופר בפלחי תאריכים ובדרישות לטווחים סופיים. הכלי Assistant מזהה עכשיו שגיאות לוגיות לפני שמריצים את השאילתה.

6. סקילים

אפשר לחשוב על מיומנות כעל פלאגין קטן או "תוכנית פעולה". ההקשר הכללי (כמו קובץ GEMINI.md) מספק מידע רקע, אבל מיומנות "נטענת" למוח של ה-AI רק כשהוא צריך לבצע משימה מורכבת ופרוצדורלית, כמו קבלת הגרסה הנוכחית של התוסף הזה. אתם לא מפעילים את המיומנות ישירות. ‫Gemini מחליט מתי הוא צריך את זה.

למרות שזו עדיין תכונה ניסיונית, כללנו אחת בגרסה הזו כדי להשלים את השימוש שלנו ב-hooks לאתחול ולניקוי של סשנים.

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

המעבר מגרסה 1.6.0 לגרסה 2.0.0 הוא לא רק הוספה של תכונות חדשות, אלא גם שיפור האמינות. גרסה 2.0 משלבת ידע מעמיק ב-API עם כלי אבחון אוטומטיים, וכך מצמצמת את לולאת הניסוי והטעייה שלעיתים קרובות מאטה את שילוב ה-API.

לא משנה אם אתם מנפים באגים בהעלאות של המרות או יוצרים צינורות עיבוד נתונים מורכבים לדיווח, גרסה 2.0 נותנת לכם את הכלים לעבוד מהר יותר ובביטחון רב יותר.

תחילת העבודה

התקנה ראשונה

שדרוג מגרסה קודמת

  • מעתיקים את כל הקוד בהתאמה אישית מ-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 כדי להתקין את התוסף ואת ספריות הלקוח.

בוב הנקוק, צוות Google Ads API

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