Yapılandırma

Ads API istemci kitaplığı, kitaplık davranışını özelleştirmek için kullanabileceğiniz çeşitli yapılandırma ayarları sağlar.

Yapılandırma dosyası

İstemciyi örneklendirirken kullanılacak bir googleads.properties dosyasını belirtebilirsiniz.

Nesne oluştururken bağımsız değişken kullanmıyorsanız:

my $api_client = Google::Ads::GoogleAds::Client->new();

ise kitaplık, dosyayı HOME dizininde arar.

Alternatif olarak bir yol da belirtebilirsiniz:

my $properties_file = "/path/to/googleads.properties";

my $api_client = Google::Ads::GoogleAds::Client->new({
  properties_file => $properties_file
});

Bu durumda istemci, dosyayı ilgili dosya yolunda arar.

Bu dosyayı oluşturmanın en kolay yolu, GitHub deposundan googleads.properties dosyasını kopyalayıp istemci kimliğinizi, istemci gizli anahtarınızı ve yenileme jetonunuzu içerecek şekilde değiştirmek olacaktır.

Dinamik yapılandırma

Yapılandırmayı, kitaplığı örneklendirirken veya daha sonra dinamik olarak ayarlayabilirsiniz:

my $api_client = Google::Ads::GoogleAds::Client->new({
  developer_token   => "INSERT_DEVELOPER_TOKEN_HERE",
  login_customer_id => "INSERT_LOGIN_CUSTOMER_ID_HERE"
});

Hatta örneği oluşturduktan sonra yapılandırmayı değiştirebilirsiniz:

$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");

API Client'den bir OAuth2ApplicationsHandler nesnesi de alabilir ve istemci kimliğini, istemci gizli anahtarını ve yenileme jetonunu çalışma zamanında 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 örneklendirirken yapılandırma ayarlarından bazılarını ortam değişkenlerinden ayarlayabilirsiniz (tam listeye bakın).

İstemci modülü, ortam değişkenlerinden değer 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'da kalıcı olan alanlar:

  • client_id: OAuth2 istemci kimliğiniz.
  • client_secret: OAuth2 istemci sırrınız.
  • refresh_token: OAuth2 yenileme jetonunuz.

API istemcisinde kalıcı alanlar:

  • developer_token: API'ye erişmek için kullandığınız geliştirici jetonunuz.
  • login_customer_id: login-customer-id belgelerine bakın.
  • proxy: İnternet bağlantısı için kullanılan proxy sunucusu URL'si.