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