ספריית הלקוח של 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, תוכלו להמשיך לשימושים הבאים בספריית הלקוח: