סקירה כללית

ספריית הלקוח של Python מתארחת ב-GitHub, והחבילה זמינה ב-PyPI.

בגרסה 10.0.0 של ספריית הלקוח בוצעו כמה שינויים בממשק שתיעדנו במסגרת גרסה 10.0.0 של הספרייה .

דרישות

בספרייה צריך להשתמש ב-Python מגרסה 3.8 ואילך.

דרישות מוקדמות

לפני התקנת הספרייה, תצטרך קוד מפתח מספר הלקוח של הלקוח. ההוראות לקבלת האימיילים מפורטות דרישות מוקדמות. שימו לב: יוצרים את אסימוני OAuth2 האחרים שנדרשים בשלבים הבאים.

התקנה

עליך לפעול לפי ההוראות בהתקנה שלנו תיעוד להתקנת הספרייה מ-PyPi ולחזרה לדף הזה.

תצורה

לאחר התקנת הספרייה, יהיה עליך להגדיר עבור את זה. יש כמה דרכים להגדיר את הספרייה, והן מתוארות במאמר מאמרי העזרה בנושא הגדרות אישיות.

אימות

אחרי שתבחרו את סוג ההגדרה, תוכלו להמשיך ביצירת אסימוני OAuth2 שנותרו שנדרשים כדי לשלוח בקשות ל-API. יש כמה מודלים בתהליכי OAuth2, המתועדים ברשימה שבהמשך. לפרטים על את ההבדלים בין התהליכים האלה ולעזור לכם להחליט מה הכי מתאים לכם לעיון במסמכי התיעוד בנושא OAuth.

שליחת בקשה ל-API

אחרי שתשלבו את אסימוני OAuth2 בהגדרה שלכם, תוכלו מוכנים לשלוח בקשת API. עיינו ב דוגמה לקבלת קמפיינים עבור דרך פשוטה לבדוק שהספרייה מוגדרת כראוי ליצירת API בקשות.

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

$ python examples/basic_operations/get_campaigns.py -c \
  INSERT_YOUR_CUSTOMER_ID_HERE

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

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