Konfigurasi

Konfigurasi dilakukan menggunakan class Config. Anda dapat mengakses kelas ini di beberapa seperti menulis file konfigurasi, menentukan nilai saat pembuatan, atau memuat nilai dari variabel lingkungan.

File konfigurasi

Anda dapat menentukan google_ads_config.rb yang digunakan saat membuat instance klien.

Jika Anda tidak menggunakan argumen saat membuat instance:

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

maka library akan mencari di lokasi yang ditentukan dalam Variabel lingkungan GOOGLE_ADS_CONFIGURATION_FILE_PATH. Jika variabel tersebut tidak disetel, library akan mencari file tersebut di direktori HOME Anda.

Atau, Anda dapat menentukan jalur:

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

dalam hal ini klien akan mencari file di jalur file tersebut.

Cara termudah untuk membuat file ini adalah dengan menyalin google_ads_config.rb dari repositori GitHub dan mengubahnya untuk menyertakan token pembaruan, ID klien, dan rahasia klien.

Konfigurasi dinamis

Anda bisa mengatur konfigurasi secara dinamis saat membuat instance library, atau bahkan setelahnya:

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

Anda bahkan dapat mengubah konfigurasi setelah pembuatan instance:

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

Kolom konfigurasi

Objek Config mendukung kolom berikut.

Kolom umum:

  • refresh_token: Token refresh OAuth Anda.
  • client_id: Client ID OAuth Anda.
  • client_secret: Rahasia klien OAuth Anda.
  • developer_token: Token developer Anda untuk mengakses API.
  • login_customer_id: Lihat dokumentasi login-customer-id.

Kolom logging. Lihat panduan logging untuk mengetahui detail selengkapnya.

  • log_level: Pesan level log minimum yang ingin Anda catat. Misalnya, menentukan 'DEBUG' akan memastikan Anda melihat semua pesan log, dan menentukan 'INFO' akan mengecualikan pesan DEBUG, tetapi menampilkan semua pesan lainnya.
  • log_target: Tempat Anda ingin login, seperti STDERR.
  • logger: Menentukan pencatat log kustom Anda sendiri. Menentukan hal ini akan mengganti log_level dan log_target.

Variabel lingkungan

Anda dapat mengonfigurasi library klien menggunakan variabel lingkungan. Tidak dimuat secara default, dan memerlukan panggilan tambahan setelah membuat instance klien Anda agar dapat dimuat. Lihat daftar lengkap variabel lingkungan didukung oleh semua bahasa.

Untuk memuat variabel lingkungan ke dalam Config, panggil load_environment_config:

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

Setiap kali ini dipanggil, keadaan saat ini dari variabel lingkungan akan menimpa apa pun yang sudah ada di Config. Dengan ini tertentu, Anda dapat misalnya memiliki konfigurasi default, tetapi menggunakan variabel lingkungan, atau Anda sepenuhnya dapat mengonfigurasi dengan variabel lingkungan.

Selain variabel lingkungan yang didukung oleh semua pustaka, alat library ini memiliki dua variabel tambahan:

  • GOOGLE_ADS_RUBY_LOG_LEVEL: Seperti log_level di atas.
  • GOOGLE_ADS_RUBY_HTTP_PROXY: Menentukan proxy HTTP.