מהו Google Ads API Developer Assistant?

‫Assistant היא לא צ'אטבוט כללי. זהו מערכת בקרה ייעודית להנדסת פרסום מבוססת-AI, שנבנתה על בסיס מסגרות הסוכנים Google Antigravity ו-Claude Code (גרסה 4.0.0).

התמונה הגדולה: פתרון בעיות שקשורות לתאימות

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

‫Google Ads API הוא אחד מממשקי ה-API הכי חזקים, אבל גם אחד מהמורכבים ביותר. הוא כולל ניהול גרסאות קפדני, שפת שאילתות ייחודית (GAQL), מבנים של מאגרי אחסון לפרוטוקולים עם קינון עמוק ודרישות בטיחות מחמירות. מפתחים משקיעים לעיתים קרובות חלק ניכר מהזמן שלהם במאבק ב-API, בניפוי באגים בשגיאות gRPC, בחיפוש של תאימות שדות ובתיקון בעיות ב-linter, במקום לבנות לוגיקה עסקית בפועל.

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

מבוסס על סכימות רשמיות, ולא על ניחושים

למודלים גדולים של שפה (LLM) יש בדרך כלל קושי עם ממשקי API ספציפיים לדומיין, כי הם מסתמכים באופן מלא על נתוני אימון כלליים, שמתיישנים במהירות כשיוצאות גרסאות חדשות של API.

הכלי Google Ads API Developer Assistant פותר את הבעיה הזו על ידי שילוב של כללים ארכיטקטוניים מוטמעים של Google Ads API עם בדיקה דינמית של סכימת Protobuf מקומית:

  • אימות דטרמיניסטי: במקום להסתמך על ניחושים איטרטיביים של מודל שפה גדול (LLM) בכמה סבבים, העוזר הדיגיטלי מריץ צינור אימות מקומי בן 4 שלבים שמאמת את התאימות של השדות, את הקשרים בין המשאבים, את הכללים לגבי אפס חשיפות ואת פילוח התאריכים בשלב אחד.
  • חיפושים מדויקים של סכימות לפי גרסה: הכלי בודק את ההגדרות של משאבי Protobuf, סוגי הנתונים וערכי ה-enum ישירות מסכימות רשמיות של API לגרסת ה-API הפעילה, וכך נמנעות שאילתות חוזרות ונשנות של מטא-נתונים מרחוק.
  • התבססות על ספריות לקוח רשמיות: יצירת הקוד מתבססת ישירות על ספריות לקוח רשמיות של Google Ads ב-Python, ב-Java, ב-PHP, ב-.NET וב-Ruby.

האנלוגיה: מעבדת מחקר ואבחון מיוחדת

אפשר לחשוב על העוזר הדיגיטלי כמעבדת מחקר מתקדמת עבור מנתח.

  • המנתח (המפתח): אתם יודעים בדיוק איזה ניתוח צריך לבצע (לדוגמה, "אני צריך לנתח את הביצועים של קמפיין למיקסום הביצועים").
  • ציוד המעבדה (ה-API): אלה הכלים המתקדמים שנדרשים לביצוע הניתוח, אבל הם מתוחכמים ודורשים כיול מדויק.
  • העוזר במעבדה (הכלי הזה): לפני שנוגעים במטופל, העוזר במעבדה משתמש במיומנויות מיוחדות ובפקודות מובנות כדי:
    1. עיון במדריכים: אימות אוטומטי של פרוטוקולי ה-API העדכניים ובדיקה של מבני המשאבים תוך כדי תנועה (inspect_object / /inspect-object).
    2. בדיקה מוקדמת של הכלים: מריצים הרצות יבשות דטרמיניסטיות על השאילתות באמצעות אימות API בזמן אמת (validate_gaql / /validate-gaql) כדי לזהות שגיאות לפני שהן קורות.
    3. ניקוי הסביבה: הפורמט והניקוי של הקוד מתבצעים באמצעות צינורות עיבוד נתונים של כלי לינטר מחמיר (ruff linting) כדי שלא יגרמו שגיאות במערכת.
    4. מעקב אחרי סימנים חיוניים: המערכת עוקבת אחרי חריגות ב-API ומריצה תהליכי עבודה מתקדמים לאבחון פעולות מורכבות כמו המרות אופליין (troubleshoot_conversions / /troubleshoot-conversions).
    5. הסבר על מושגים: הסבר על מושגים מורכבים בשפה יומיומית באמצעות אנלוגיות מהעולם האמיתי (/explain, /step-by-step, /assistant-tutorial).

קישוריות: הגשר 'קודם כל בטיחות'

ה-Assistant משמש כגשר שמקשר בין ארבעה 'עולמות' שונים בפרויקט, הכפופים לחוזים מחייבים (AGENTS.md / CLAUDE.md):

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

מה Assistant עושה בפועל

במילים פשוטות, העוזר הדיגיטלי הוא אמצעי הגנה ומאיץ.

  • הוא מונע טעויות: הוא מאמת את הקוד והשאילתות מול סכימות פעילות של API לפני ההפעלה, ועוצר שגיאות תחביר ושגיאות תאימות לפני שהן מגיעות ל-API הפעיל.
  • הוא מכיר את המפה: הוא מבין את הגיאוגרפיה של Google Ads API – איפה הנתונים נמצאים ואיך לשלוח שאילתות לגביהם ביעילות.
  • הוא מבצע אוטומטית את הפעולות המשעממות: הוא כותב קוד של ספריית לקוח סטנדרטית, מעצב דוחות לטבלאות מסודרות במסוף ומטפל בפרטים הטכניים של ספריית הלקוח.
  • הכלי פותר בעיות בתהליכי עבודה מורכבים: הוא מריץ אבחון מעמיק בהעלאות של המרות אופליין, פותר היררכיות של חשבונות ניהול ומגדיר מבני קמפיינים מורכבים כמו מסנני כרטיסי מוצר והחרגות של כתובות URL בקמפיינים למיקסום הביצועים.
  • הוא מזרים דוחות אד-הוק בזמן אמת: אפשר לבקש נתוני ביצועים באנגלית פשוטה, והעוזר הדיגיטלי יוצר, מאמת ומריץ שאילתות GAQL ישירות בחשבון שלכם, ומזרים תוצאות מפורמטות למסוף או מייצא אותן ל-CSV.
  • הוא תמיד מעודכן: הוא בודק את סכימות ה-Protobuf המקומיות ואת התיעוד של גרסת ה-API הפעילה, וכך עוזר לכם להימנע משדות שהוצאו משימוש ומכללים לא עדכניים.

הכלי Google Ads API Developer Assistant (עוזר למפתחים של Google Ads API) הופך את המאבק בין המפתחים לבין ה-API לשיתוף פעולה בין המפתחים לבין ה-AI, שיוצר קוד בטוח, אידיומטי ובעל ארכיטקטורה תקינה.

ארכיטקטורה וביצועים (גרסה 4.0.0)

בגרסה 4.0.0, העוזר עובר מהגדרת פרויקט עצמאי לארכיטקטורת פלאגין גלובלית ומודרנית:

  • תקורה של אפס דימונים: סקילים ופקודות אבחון מופעלות באופן ארעי כתהליכי צאצא קלי משקל רק כשקוראים להן, וכשהן בלי פעילות, השימוש במשאבי המערכת יורד לאפס.
  • חשיפה הדרגתית של הקשר: הכללים והסכימות נטענים לפי דרישה רק כשהם רלוונטיים למשימה הפעילה, וכך מצטמצם באופן משמעותי השימוש בטוקנים וההשהיה של ההנחיות.
  • צמצום קלט/פלט בדיסק: הסרת קבצים מיותרים של ה-SDK מעץ הפלאגין מונעת מסורקי אינדקס, כלי ניתוח וצופים בקבצים של סביבת הפיתוח המשולבת (IDE) לסרוק עשרות אלפי קבצים שלא נמצאים בשימוש.
  • תמיכה במארחים מרובי פלטפורמות: פועל בצורה חלקה בסביבות Google Antigravity ו-Claude Code עם סקריפטים מאוחדים להתקנה ב-Linux, ב-macOS וב-Windows.

השלבים הבאים

הבא
התקנה ושימוש ב-Google Ads API Developer Assistant