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 hemlog_level
hem delog_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ıdalog_level
olarak.GOOGLE_ADS_RUBY_HTTP_PROXY
: Bir HTTP proxy belirtin.