ספריית הלקוח של Python מתארחת ב-GitHub, והחבילה זמינה ב-PyPI.
דרישות
הספרייה מחייבת Python 3.9 ואילך.
דרישות מוקדמות
לפני שממשיכים במדריך הזה, צריך לדעת מהו מספר הלקוח בן 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, תוכלו להמשיך לשימושים הבאים בספריית הלקוח: