ספריית הלקוח של Python מתארחת ב-GitHub, והחבילה זמינה ב-PyPI.
דרישות
הספרייה מחייבת Python 3.9 ואילך.
דרישות מוקדמות
לפני שממשיכים במדריך הזה, צריך קוד מפתח ל-Google Ads API ומספר לקוח בן 10 ספרות של חשבון Google Ads.
תאימות של זמן ריצה ותלות
ספריית הלקוח של Python שומרת על תאימות לזמני הריצה של Python שמפורטים בקטע גרסאות נתמכות שפורסם על ידי Python Software Foundation, למעט גרסאות עם סטטוס 'תכונה' או 'גרסת טרום-הפצה'.
אנחנו שואפים לאמץ גרסאות חדשות של Python Runtime ברגע שהן מושקות ונתמכות באופן רשמי על ידי Python Software Foundation.
אין תמיכה בסביבות זמן ריצה של Python שהגיעו לסוף החיים (EOL) אחרי תאריך ה-EOL בקטע Unsupported Versions באתר python.org. אנחנו לא יכולים להבטיח תאימות לזמני ריצה של EOL, כי יכול להיות שנשיק גרסה של הספרייה שלא תהיה תואמת להם בכל שלב אחרי תאריך ה-EOL שלהם.
במקרה של תלות (במיוחד, כל החבילות ש-Google מתחזקת ומופיעות כחבילות נדרשות בספריית הלקוח של Google API ל-Python), נשמור על תאימות לחבילות ש-Google מתחזקת ונחשבות כחבילות 'נתמכות' בהתאם למדיניות של Google בנושא שינויים שעלולים לשבור תאימות ב-OSS.
רשימה מלאה של סביבות זמן ריצה ותלויות נתמכות של Python זמינה בדף תלויות.
התקנה
במדריך ההתקנה שלנו מפורטות כל הדרכים השונות להתקנת הספרייה. הדרך הכי פשוטה (ומומלצת) להתקין את הספרייה באפליקציה היא באמצעות pip:
$ python -m pip install google-ads
הגדרות אישיות
אחרי שמתקינים את הספרייה, צריך להגדיר אותה. יש כמה דרכים להגדיר את הספרייה, והן מתוארות במדריך ההגדרה.
אימות
אחרי שבוחרים את שיטת ההגדרה, אפשר להגדיר את אימות המשתמשים. הוראות מפורטות זמינות במדריך לאימות בספריית הלקוח של Python. מידע כללי נוסף זמין בסקירה הכללית על OAuth.
שליחת בקשת API
אחרי שמגדירים את האימות, אפשר לשלוח בקשת API. כדי לבדוק במהירות שהספרייה מוגדרת בצורה תקינה לשליחת בקשות API, אפשר לעיין בדוגמה של get campaigns.
כדי להריץ את הדוגמה get_campaigns.py, בספריית הבסיס של ספריית הלקוח googleads-python שהתקנתם באופן מקומי, מריצים את הפקודה הבאה:
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_CUSTOMER_ID_HERE
מקורות מידע נוספים
אחרי שתוכלו לשלוח בקשת API, תוכלו להמשיך לשימושים הבאים בספריית הלקוח: