Ads API İstemci Kitaplığı, kitaplık davranışını özelleştirmek için kullanabileceğiniz çeşitli yapılandırma ayarları sağlar.
Yapılandırma dosyası
İstemci örneği oluşturulurken kullanılacak bir googleads.properties
dosyası belirtebilirsiniz.
Örnek oluştururken bağımsız değişken kullanmıyorsanız:
my $api_client = Google::Ads::GoogleAds::Client->new();
Bunu yaptığınızda kitaplık, dosya için HOME
dizininizde görünür.
Alternatif olarak bir yol belirtebilirsiniz:
my $properties_file = "/path/to/googleads.properties";
my $api_client = Google::Ads::GoogleAds::Client->new({
properties_file => $properties_file
});
Bu durumda istemci dosyayı bu dosya yolunda arar.
Bu dosyayı oluşturmanın en kolay yolu googleads.properties
deposunu GitHub deposundan kopyalayıp istemci kimliğinizi, istemci gizli anahtarınızı ve yenileme jetonunuzu içerecek şekilde değiştirmektir.
Dinamik yapılandırma
Yapılandırmayı, kitaplık için örnek oluştururken dinamik olarak veya daha sonra bile ayarlayabilirsiniz:
my $api_client = Google::Ads::GoogleAds::Client->new({
developer_token => "INSERT_DEVELOPER_TOKEN_HERE",
login_customer_id => "INSERT_LOGIN_CUSTOMER_ID_HERE"
});
Örneklendirmeden sonra da yapılandırmayı değiştirebilirsiniz:
$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");
Ayrıca API Client
kaynağından bir OAuth2ApplicationsHandler nesnesi alabilir ve çalışma zamanında istemci kimliğini, istemci gizli anahtarını ve yenileme jetonunu değiştirebilirsiniz:
my $oauth2_applications_handler = $api_client->get_oauth2_applications_handler();
$oauth2_applications_handler->set_client_id("INSERT_CLIENT_ID");
$oauth2_applications_handler->set_client_secret("INSERT_CLIENT_SECRET");
$oauth2_applications_handler->set_refresh_token("INSERT_REFRESH_TOKEN");
Yapılandırma ortamı değişkenleri
İstemcileri tetiklerken ortam değişkenlerindeki bazı yapılandırma ayarlarını belirleyebilirsiniz (kapsamlı listeyi inceleyin).
İstemci modülü, ortam değişkenlerinden değerler yüklemek için configure_from_environment_variables
işlevini sağlar:
# Get the Google Ads Client. By default, any credentials will be read from
# ~/googleads.properties, or, if set, from the file specified in the
# GOOGLE_ADS_CONFIGURATION_FILE_PATH environment variable.
my $api_client = Google::Ads::GoogleAds::Client->new();
# Load the configuration from any set environment variables.
$api_client->configure_from_environment_variables();
Yapılandırma alanları
Yapılandırma özellikleri aşağıdaki alanları destekler:
OAuth2ApplicationsHandler üzerinde kalıcı olan alanlar:
client_id
: OAuth2 istemci kimliğiniz.client_secret
: OAuth2 istemci gizli anahtarınız.refresh_token
: OAuth2 yenileme jetonunuz.
API İstemcisinde kalıcı olan alanlar:
developer_token
: API'ye erişmek için kullandığınız geliştirici jetonunuzdur.login_customer_id
: login-customer-id belgelerini inceleyin.proxy
: İnternet bağlantısı için kullanılan proxy sunucu URL'si.