設定

您可以使用 Config 類別進行設定。您可以在 例如編寫設定檔、在建立時指定值,或 從環境變數載入值。

設定檔

您可以指定 google_ads_config.rb敬上 檔案。

如果您在例項化時不使用引數:

client = Google::Ads::GoogleAds::GoogleAdsClient.new

則程式庫會搜尋 GOOGLE_ADS_CONFIGURATION_FILE_PATH 環境變數。如果該變數是 如未設定,程式庫會在 HOME 目錄中尋找該檔案。

或者,您也可以指定路徑:

client = Google::Ads::GoogleAds::GoogleAdsClient.new("path/to/file.rb")

在此情況下,用戶端會在該檔案路徑中尋找檔案。

產生這個檔案最簡單的方式,是將 google_ads_config.rb 從 將其修改為加入更新權杖、用戶端 ID 和用戶端密碼

動態設定

您可以在建立程式庫例項時,以動態方式進行設定。 甚至之後:

client = Google::Ads::GoogleAds::GoogleAdsClient.new do |config|
  config.client_id = 'INSERT_CLIENT_ID_HERE'
  # ... more configuration
end

您甚至可以在建立例項後修改設定:

client.configure do |config|
  config.login_customer_id = 'INSERT_LOGIN_CUSTOMER_ID_HERE'
  # ... more configuration
end

設定欄位

Config 物件支援下列欄位。

一般欄位:

  • refresh_token:您的 OAuth 更新憑證。
  • client_id:您的 OAuth 用戶端 ID。
  • client_secret:您的 OAuth 用戶端密鑰。
  • developer_token:用來存取 API 的開發人員權杖。
  • login_customer_id:請參閱 login-customer-id 說明文件

記錄欄位。如需完整的詳細資訊,請參閱記錄指南

  • log_level:您要記錄的最低記錄層級訊息。例如: 指定 'DEBUG' 可確保查看所有記錄訊息 'INFO' 會排除 DEBUG 郵件,但顯示其他所有訊息。
  • log_target:您想登入的位置,例如 STDERR
  • logger:指定您自己的自訂記錄器。指定這個選項會覆寫 《log_level》和《log_target》。

環境變數

您可以使用環境變數來設定用戶端程式庫。他們不是 預設會載入,而且在實例化 用戶端載入版本。查看環境變數的完整清單 所有支援的 語言

如要將環境變數載入 Config,請呼叫 load_environment_config

client = Google::Ads::GoogleAds::GoogleAdsClient.new
client.load_environment_config

每次呼叫這個方法時,環境變數的目前狀態就會 覆寫 Config 中現有的任何內容。使用這項 機制,例如採用預設設定,但會覆寫特定 定義自己的環境變數,或者完全以 環境變數

除了所有程式庫支援的環境變數外,Ruby 程式庫還有兩個其他變數:

  • GOOGLE_ADS_RUBY_LOG_LEVEL:如上述 log_level
  • GOOGLE_ADS_RUBY_HTTP_PROXY:指定 HTTP Proxy。