Yapılandırma

Yapılandırma, bir Config sınıfı kullanılarak yapılır. Bu sınıfa birden fazla uygulamada erişebilirsiniz yapılandırma dosyası yazma, oluşturma sırasında değerleri belirtme veya ortam değişkenlerinden değer yükleme.

Yapılandırma dosyası

Hedeflerinize göre bir google_ads_config.rb örnek oluştururken kullanılacak bir dosyadır.

Örnekleme sırasında bağımsız değişken kullanmıyorsanız:

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

kitaplık, burada belirtilen konuma GOOGLE_ADS_CONFIGURATION_FILE_PATH ortam değişkeni. Bu değişken ayarlanmazsa kitaplık, dosyayı HOME dizininizde arar.

Alternatif olarak bir yol da belirtebilirsiniz:

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

Bu durumda, istemci dosyayı o dosya yolunda arar.

Bu dosyayı oluşturmanın en kolay yolu google_ads_config.rb öğesini kod deposunu bulun ve bunu, yenileme jetonunuzu, istemci kimliğinizi, ve istemci gizli anahtarı.

Dinamik yapılandırma

Kitaplığı örneklendirirken yapılandırmayı dinamik olarak ayarlayabilirsiniz. hatta daha sonra bile oluşturabilirsiniz:

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

Örnekleme işleminden sonra da yapılandırmayı değiştirebilirsiniz:

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

Yapılandırma alanları

Config nesnesi aşağıdaki alanları destekler.

Genel alanlar:

  • refresh_token: OAuth yenileme jetonunuz.
  • client_id: OAuth istemci kimliğiniz.
  • client_secret: OAuth istemci gizli anahtarınız.
  • developer_token: API'ye erişmek için geliştirici jetonunuz.
  • login_customer_id: Bkz. login-customer-id dokümanlarına bakın.

Günlük kaydı alanları. Tüm ayrıntılar için günlük kaydı kılavuzuna bakın.

  • log_level: Günlüğe kaydedilmesini istediğiniz minimum günlük düzeyindeki iletilerdir. Örneğin, 'DEBUG' belirterek tüm günlük mesajlarını görebilir ve 'INFO', DEBUG mesajlarını hariç tutar ancak diğer tüm iletileri gösterir.
  • log_target: Giriş yapmak istediğiniz yer (ör. STDERR).
  • logger: Kendi özel günlük kaydedicinizi belirtin. Bunun belirtilmesi, log_level ve log_target.

Ortam değişkenleri

İstemci kitaplığını ortam değişkenlerini kullanarak yapılandırabilirsiniz. Bunlar: ve örnek oluşturduktan sonra ek bir çağrı gerektirmesi için, yüklenmesi gerekir. Ortam değişkenlerinin tam listesine bakın herkes tarafından desteklenir dillerini inceleyin.

Ortam değişkenlerini Config cihazınıza yüklemek için load_environment_config yöntemini çağırın:

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

Bu her çağrıldığında, ortam değişkenlerinin mevcut durumu Config ürününde mevcut olan her şeyin üzerine yazılır. Bununla bir mekanizmayı kullanıyorsanız, örneğin varsayılan bir yapılandırmanız olabilir, ancak değerlerini kullanabilir veya isteğe bağlı olarak değişkenlerine odaklanmalıdır.

Tüm kitaplıklar tarafından desteklenen ortam değişkenlerine ek olarak, Ruby kitaplığında iki ek değişken vardır:

  • GOOGLE_ADS_RUBY_LOG_LEVEL: Yukarıda log_level olarak.
  • GOOGLE_ADS_RUBY_HTTP_PROXY: Bir HTTP proxy belirtin.