Cấu hình

Việc định cấu hình được thực hiện bằng một lớp Config. Bạn có thể truy cập vào lớp học này trong nhiều chẳng hạn như viết tệp cấu hình, chỉ định giá trị khi tạo hoặc đang tải giá trị từ các biến môi trường.

Tệp cấu hình

Bạn có thể chỉ định một google_ads_config.rb để sử dụng khi tạo thực thể ứng dụng.

Nếu bạn không sử dụng đối số khi tạo thực thể:

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

thì thư viện sẽ tìm ở vị trí được chỉ định trong Biến môi trường GOOGLE_ADS_CONFIGURATION_FILE_PATH. Nếu biến đó là chưa được đặt, thì thư viện sẽ tìm tệp đó trong thư mục HOME.

Ngoài ra, bạn có thể chỉ định một đường dẫn:

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

trong trường hợp đó, ứng dụng sẽ tìm tệp tại đường dẫn tệp đó.

Cách dễ nhất để tạo tệp này là sao chép google_ads_config.rb từ kho lưu trữ GitHub và sửa đổi kho lưu trữ đó để bao gồm mã làm mới, mã ứng dụng khách và mật khẩu ứng dụng khách.

Cấu hình động

Bạn có thể thiết lập cấu hình một cách linh động khi tạo thực thể cho thư viện, hoặc thậm chí là sau đó:

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

Bạn thậm chí có thể sửa đổi cấu hình sau khi tạo bản sao:

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

Trường cấu hình

Đối tượng Config hỗ trợ các trường sau.

Các trường chung:

  • refresh_token: Mã làm mới OAuth của bạn.
  • client_id: Mã ứng dụng OAuth của bạn.
  • client_secret: Mật khẩu ứng dụng OAuth của bạn.
  • developer_token: Mã của nhà phát triển để truy cập vào API.
  • login_customer_id: Xem tài liệu vềlogin-customer-id.

Trường ghi nhật ký. Xem hướng dẫn ghi nhật ký để biết đầy đủ chi tiết.

  • log_level: Thông báo ở cấp độ nhật ký tối thiểu mà bạn muốn ghi lại. Ví dụ: việc chỉ định 'DEBUG' sẽ đảm bảo bạn nhìn thấy tất cả thông điệp nhật ký và chỉ định 'INFO' sẽ loại trừ các thông báo GỠ LỖI nhưng hiện tất cả các thông báo khác.
  • log_target: Nơi bạn muốn đăng nhập, chẳng hạn như STDERR.
  • logger: Chỉ định trình ghi nhật ký tuỳ chỉnh của riêng bạn. Việc chỉ định thuộc tính này sẽ ghi đè cả hai thuộc tính log_level và log_target.

Biến môi trường

Bạn có thể định cấu hình thư viện ứng dụng bằng cách sử dụng các biến môi trường. Không được tải theo mặc định và yêu cầu thực hiện lệnh gọi bổ sung sau khi tạo thực thể để tải. Xem danh sách đầy đủ các biến môi trường được hỗ trợ bởi tất cả ngôn ngữ.

Để tải các biến môi trường vào Config, hãy gọi load_environment_config:

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

Mỗi lần phương thức này được gọi, trạng thái hiện tại của các biến môi trường sẽ ghi đè mọi nội dung đã có trong Config. Bằng cách này , ví dụ: bạn có thể có cấu hình mặc định nhưng ghi đè cấu hình cụ thể bằng cách sử dụng các biến môi trường hoặc bạn hoàn toàn có thể định cấu hình bằng biến môi trường.

Ngoài các biến môi trường được tất cả thư viện hỗ trợ, Ruby thư viện có hai biến bổ sung:

  • GOOGLE_ADS_RUBY_LOG_LEVEL: Như log_level ở trên.
  • GOOGLE_ADS_RUBY_HTTP_PROXY: Chỉ định proxy HTTP.