כלי העזר למפתחים של Google Ads API

התוסף Google Ads API Developer Assistant הוא תוסף עוצמתי ל-Gemini CLI שנועד להאיץ את תהליכי העבודה שלכם ב-Google Ads API. ה-Assistant מאפשר לכם לקיים אינטראקציה עם Google Ads API באמצעות שפה טבעית, וכך לשאול שאלות, ליצור קוד, לאחזר נתונים ולפתור בעיות ישירות במסוף.

יתרונות

  • שיפור הפרודוקטיביות: חוסכים זמן בחיפוש תיעוד ובכתיבת קוד סטנדרטי.
  • מפשטים משימות מורכבות: יוצרים קוד של שפת השאילתות של Google Ads‏ (GAQL) וספריית לקוחות מתוך הנחיות פשוטות באנגלית.
  • לומדים על ה-API: מבינים את המושגים שקשורים ל-API ורואים איך בקשות בשפה טבעית מתורגמות לקוד שניתן להרצה.
  • ניפוי באגים אינטראקטיבי: קבלת עזרה בהבנת שגיאות והנחיות מפורטות לפתרון בעיות.
  • תהליך עבודה יעיל יותר: אפשר לבצע את מחזור הפיתוח והבדיקה בשורת הפקודה.

דרישות מוקדמות

לפני שמתחילים, חשוב לוודא שהתנאים הבאים מתקיימים:

  1. גישה אל Google Ads API:

  2. תוכנה:

    • ‫Python בגרסה 3.10 ואילך. ‫Python היא שפת ברירת המחדל, ולכן היא צריכה להיות מותקנת ומוגדרת בנתיב.
    • Gemini CLI מותקן.
    • ‫jq (מעבד JSON בשורת הפקודה). אם התוכנה לא מותקנת, סקריפט ההגדרה ינסה להתקין אותה.

  3. מאגר:

    • עותק מקומי של מאגר google-ads-api-developer-assistant מ-GitHub:

שנתחיל?

  1. עוברים לספריית הפרויקט:

    cd <full path>/google-ads-api-developer-assistant

  2. מריצים את סקריפט ההגדרה: הסקריפט הזה מגדיר את Gemini CLI כך שישתמש בקובצי ההקשר ובכלים הנדרשים של העוזר הדיגיטלי GEMINI.md.

    ./setup.sh

    אם אתם משתמשים ב-Windows, מריצים את setup.ps1 סקריפט PowerShell.

  3. מפעילים את Gemini CLI:

    gemini

  4. אינטראקציה עם Assistant: עכשיו אפשר לשאול שאלות או לתת פקודות בשפה טבעית.

תכונות עיקריות

  • שאלות ותשובות בשפה טבעית: אפשר לשאול שאלות על תכונות של Google Ads API, על שיטות מומלצות או על משאבים ספציפיים.

    • מהם סוגי הקמפיינים הזמינים?
    • "איך מסננים לפי תאריך ב-GAQL?"
    • "תסביר את ההבדל בין click_view לבין impression_view".

  • יצירת קוד: יצירת שאילתות GAQL וקטעי קוד Python שניתן להפעיל.

    • "תציג לי את הקמפיינים עם הכי הרבה המרות ב-30 הימים האחרונים".
    • "קבל את כל השמות של קבוצות המודעות שמופעלות בקמפיין מספר 12345".
    • "איתור מודעות שלא אושרו בכל הקמפיינים" הקוד שנוצר נשמר בספרייה saved_code/.

  • הרצה ישירה של API: הרצה ישירה של סקריפטים של Python שנוצרו לקריאה בלבד מ-Gemini CLI, וצפייה בתוצאות מעוצבות בטרמינל. אחרי שה-Assistant ייצור את הקוד, תוצג הנחיה במסך:

To run this script, you will need to replace YOUR_CUSTOMER_ID with your actual
Google Ads customer ID and execute the following command in
your shell: <command>

מזינים run והסקריפט יופעל בהקשר של Assistant.

  • ייצוא CSV: שמירת תוצאות טבלאיות מקריאות API בקובץ CSV.

    • שומרים את התוצאות בקובץ CSV. הקבצים נשמרים בספרייה saved_csv/.

  • עזרה בפתרון בעיות: קבלת עזרה לגבי הודעות שגיאה או התנהגות לא צפויה של ה-API.

    • "קיבלתי את השגיאה 'AuthenticationError.OAUTH_TOKEN_INVALID', מה צריך לעשות?"
    • "למה לא מוצגות תוצאות לשאילתה שלי?"

תרחישים לדוגמה

  • דיווח:
    • "תביא לי את 5 מילות המפתח המובילות לפי עלות בחודש שעבר עבור לקוח מספר 12345678".
  • מבנה החשבון:
    • "תציג את כל שמות הקמפיינים ואת המזהים שלהם".
  • פתרון בעיות:
    • "העליתי 100 המרות, אבל רק 78 מופיעות בממשק המשתמש. איך אפשר לנפות באגים באמצעות ה-API?"
  • למידה:
    • "תסביר לי איך ליצור קמפיין למיקסום הביצועים באמצעות ה-API".

תמיכה וקהילה

הנחיות להוספת תוכן

נשמח לקבל תרומות. הנחיות זמינות בקובץ CONTRIBUTING.md במאגר GitHub.