ספריית הלקוח של 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 שמפורטים בקטע גרסאות נתמכות שפורסם על ידי Python Software Foundation, למעט גרסאות עם סטטוס 'תכונה' או 'גרסת טרום-הפצה'.
צוות 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. אפשר לעיין בדוגמה של get campaigns כדי לבדוק במהירות שהספרייה מוגדרת בצורה תקינה לשליחת בקשות ל-API.
כדי להריץ את הדוגמה get_campaigns.py, קודם צריך לשכפל את מאגר google-ads-python. לאחר מכן, מהספרייה הבסיסית של המאגר המשוכפל, מריצים את הפקודה הבאה:
python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE
מקורות מידע נוספים
אחרי שתוכלו לשלוח בקשת API, תוכלו להמשיך לשימושים הבאים בספריית הלקוח: