הגדרה של ספריית לקוח ב-Python

התקנה של ספריית הלקוח של Python

כדי להתקין את ספריית הלקוח של Python בסביבה המקומית:

  1. מחלקים את קובץ ה-tarball של ספריית הלקוח Python.
  2. מריצים את הפקודה הבאה באותה ספרייה:

    python -m pip install .
    
  3. פועלים לפי ההנחיות במסוף כדי להשלים את ההתקנה.

הגדרה באמצעות קובץ YAML

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

כדי לציין את המיקום של הקובץ search-ads-360.yaml, אפשר להעביר את הנתיב כמחרוזת ל-method כשקוראים לו:

from util_searchads360 import SearchAds360Client
client = SearchAds360Client.load_from_file("path/to/search-ads-360.yaml")

אם לא תציינו נתיב, הספרייה תחפש את הקובץ בספרייה $HOME:

from util_searchads360 import SearchAds360Client
client = SearchAds360Client.load_from_file()

שדות ההגדרה

ההגדרה של ספריית הלקוח תומכת בשדות הבאים.

שדות כלליים:

מפתחות נתמכים לרצפי פעולות באפליקציות למחשב ולאפליקציות אינטרנט

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

# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
client_id: INSERT_CLIENT_ID_HERE

# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
client_secret: INSERT_CLIENT_SECRET_HERE

# Renewable OAuth credential associated with 1 or more Search Ads accounts.
refresh_token: INSERT_REFRESH_TOKEN_HERE

# Required for manager accounts only: Specify the login customer ID used to
# authenticate API calls. This will be the customer ID of the authenticated
# manager account. You can also specify this later in code if your application
# uses multiple manager account + OAuth pairs.
#
# login_customer_id: INSERT_LOGIN_CUSTOMER_ID_HERE