Yapılandırma

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

Yapılandırma dosyası

İstemci örneği oluşturulurken kullanılacak bir google_ads_config.rb dosyası belirtebilirsiniz.

Örnek oluştururken bağımsız değişken kullanmazsanız:

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

kitaplık, GOOGLE_ADS_CONFIGURATION_FILE_PATH ortam değişkeninde belirtilen konuma bakar. 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ı bu dosya yolunda arar.

Bu dosyayı oluşturmanın en kolay yolu, google_ads_config.rb deposunu GitHub deposundan kopyalayıp yenileme jetonunu, istemci kimliğini ve istemci gizli anahtarını içerecek şekilde değiştirmektir.

Dinamik yapılandırma

Kitaplığı örneklendirmek için yapılandırmayı dinamik bir şekilde ayarlayabilir veya daha sonra:

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

Örnekleme sonrasında yapılandırmayı da 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 kullandığınız geliştirici jetonunuz.
  • login_customer_id: login-customer-id belgelerini inceleyin.

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üzeyinde mesajlar. Örneğin, 'DEBUG' belirtilmesi tüm günlük mesajlarını görmenizi sağlar. 'INFO' belirtirseniz HATA AYIKLAMA mesajları hariç tutulur ancak diğer tüm mesajlar gösterilir.
  • log_target: STDERR gibi, giriş yapmak istediğiniz yerdir.
  • logger: Kendi özel günlük kaydedicinizi belirtin. Bunu belirttiğinizde hem log_level hem de log_target geçersiz kılınır.

Ortam değişkenleri

Ortam değişkenlerini kullanarak istemci kitaplığını yapılandırabilirsiniz. Bunlar varsayılan olarak yüklenmez ve yüklenmeleri için istemciyi örnekledikten sonra ek bir çağrı yapılmasını gerektirirler. Tüm diller tarafından desteklenen ortam değişkenlerinin tam listesine bakın.

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 işlev her çağrıldığında, ortam değişkenlerinin mevcut durumu Config öğesinde zaten bulunan her şeyin üzerine yazar. Bu sistem sayesinde, örneğin varsayılan bir yapılandırmanız olabilir ancak ortam değişkenlerini kullanarak belirli değerleri geçersiz kılabilir ya da tamamen ortam değişkenleriyle yapılandırabilirsiniz.

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

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