התקנת ספריית הלקוח של Python
כדי להתקין את ספריית הלקוח של Python בסביבה המקומית:
- מחלצים את ה-tarball של ספריית הלקוח של Python.
מריצים את הפקודה הבאה באותה ספרייה:
python -m pip install .
פועלים לפי ההנחיות בטרמינל כדי להשלים את ההתקנה.
הגדרה באמצעות קובץ YAML
אפשר לציין קובץ YAML שישמש לאתחול הלקוח שמכיל את פרטי האימות הנדרשים כדי לשלוח בקשות. אפשר לגשת לקובץ הזה
כשלקוח מאותחל באמצעות השיטה load_from_file
.
כשיוצרים קובץ YAML, כדאי לפעול לפי הדוגמה הבאה כדי לציין את אסימון הרענון, מזהה הלקוח וסוד הלקוח.
כדי לציין את המיקום שבו הקובץ search-ads-360.yaml
ממוקם, אפשר להעביר את הנתיב כמחרוזת לשיטה בזמן הקריאה:
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()
שדות הגדרה
התצורה של ספריית הלקוח תומכת בשדות הבאים.
שדות כלליים:
refresh_token
: אסימון הרענון של OAuth.client_id
: מזהה הלקוח ב-OAuth.client_secret
: הסוד של לקוח OAuth שלך.login_customer_id
: קראו את מסמכי התיעוד בנושא מספר לקוח להתחברות.
מפתחות נתמכים לתהליכי עבודה בשולחן העבודה ובאפליקציית אינטרנט
אם משתמשים בתהליך האפליקציה למחשב או לאינטרנט, המפתחות הנתמכים הם:
# 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