پیکربندی کتابخانه کلاینت پایتون

کتابخانه کلاینت پایتون را نصب کنید

برای نصب کتابخانه کلاینت پایتون در محیط محلی خود:

  1. tarball کتابخانه کلاینت پایتون را استخراج کنید.

  2. دستور زیر را در همان دایرکتوری اجرا کنید:

    python -m pip install .

  3. برای تکمیل نصب، دستورات موجود در ترمینال را دنبال کنید.

پیکربندی با استفاده از فایل 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 : مستندات 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