Python 用戶端程式庫設定

安裝 Python 用戶端程式庫

如要在本機環境中安裝 Python 用戶端程式庫，請按照下列步驟操作：

1. 解壓縮 Python 用戶端程式庫 tarball。

2. 在同一個目錄中執行下列指令：

   python -m pip install .
   

3. 按照終端機顯示的提示完成安裝程序。

注意： 請勿使用 python setup.py 安裝 Python 用戶端程式庫。這可能會導致依附元件問題。

使用 YAML 檔案進行設定

您可以在初始化用戶端時指定要使用的 YAML 檔案，該檔案包含提出要求所需的必要驗證資訊。當用戶端使用 load_from_file 方法初始化時，系統會存取這個檔案。建立 YAML 檔案時，請按照下方提供的範例指定重新整理權杖、用戶端 ID 和用戶端密鑰。

注意： 您可以執行提供的使用者憑證產生指令碼，或使用 OAuth Playground 公用程式產生 OAuth 更新權杖。

如要指定 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 用戶端 ID。
• 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