ספריית הלקוח של Python מתארחת ב-GitHub, והחבילה זמינה ב-PyPI.
דרישות
הספרייה תומכת ב-Python מגרסה 3.9 עד 3.14 (>=3.9, <3.15; התמיכה ב-Python 3.14 נוספה ב-v28.2.0). מכיוון ש-Python 3.9 ו-3.10 מציגות אזהרת הוצאה משימוש בייבוא ב-google-ads v32.0.0 ואילך, מומלץ להשתמש ב-Python 3.11 ואילך.
דרישות מוקדמות
לפני שתמשיכו, אתם צריכים את מספר הלקוח בן 10 הספרות של חשבון Google Ads שלכם.
תאימות של סביבת זמן הריצה ויחסי התלות
ספריית הלקוח של Python שומרת על תאימות עם סביבות זמן הריצה של Python בקטע Supported Versions שפורסם על ידי Python Software Foundation, חוץ מגרסאות עם הסטטוס feature או prerelease.
צוות Google Ads API שואף לאמץ גרסאות חדשות של סביבת זמן הריצה של Python ברגע שהן מתפרסמות ונתמכות באופן רשמי על ידי Python Software Foundation.
סביבות זמן ריצה של Python שהגיעו לסוף החיים שלהן (EOL) לא נתמכות אחרי תאריך ה-EOL בקטע Unsupported Versions באתר python.org. אנחנו לא יכולים להבטיח תאימות לסביבות זמן ריצה שהגיעו לסוף החיים שלהן, כי גרסאות של הספרייה שיוצאות אחרי תאריך סוף החיים עלולות לפגוע בתאימות.
לגבי יחסי תלות (ספציפית, כל החבילות שמתוחזקות על ידי Google ומוגדרות כנדרשות על ידי ספריית הלקוח של Python), התאימות נשמרת עם חבילות שמתוחזקות על ידי Google ונחשבות כ"נתמכות" בהתאם למדיניות של Google בנושא שינויי תוכנה שעלולים לגרום לכשל ב-OSS.
לרשימה המלאה של סביבות זמן הריצה של Python ויחסי התלות שנתמכים, ראו את הדף יחסי תלות.
התקנה
במדריך ההתקנה מפורטות כל הדרכים השונות להתקנת הספרייה. הדרך הפשוטה (והמומלצת) להתקין את הספרייה באפליקציה היא באמצעות pip:
python -m pip install google-ads
הגדרות אישיות
אחרי שמתקינים את הספרייה, צריך להגדיר אותה. יש כמה דרכים להגדיר את הספרייה, והן מתוארות במדריך להגדרה.
אימות
אחרי שבוחרים גישה להגדרה, מגדירים את האימות. הוראות מפורטות מופיעות במדריך לאימות של ספריית הלקוח ב-Python. לרקע כללי נוסף, קראו את הסקירה הכללית על OAuth.
שליחת בקשת API
אחרי שמגדירים את האימות, אפשר לשלוח בקשת API. כדי לבדוק במהירות אם הספרייה מוגדרת כמו שצריך לשליחת בקשות API, אפשר לעיין בדוגמה get campaigns.
כדי להריץ את הדוגמה של get_campaigns.py, קודם צריך לשכפל את מאגר google-ads-python. לאחר מכן, מריצים את הפקודה הבאה מתיקיית השורש של המאגר המשוכפל:
python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE
מקורות מידע נוספים
אחרי שתוכלו לשלוח בקשת API, תוכלו להמשיך לשימושים הבאים בספריית הלקוח: