סקירה כללית

ספריית הלקוח של 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. אפשר לעיין בדוגמה של get campaigns כדי לבדוק במהירות שהספרייה מוגדרת בצורה תקינה לשליחת בקשות ל-API.

כדי להריץ את הדוגמה get_campaigns.py, קודם משכפלים את מאגר google-ads-python. לאחר מכן, מריצים את הפקודה הבאה מתיקיית השורש של המאגר המשוכפל:

python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE

מקורות מידע נוספים

אחרי שתוכלו לשלוח בקשת API, תוכלו להמשיך לשימושים הבאים בספריית הלקוח: