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ı belirtebilirsiniz.

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

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

bu durumda kitaplık, dosyayı HOME dizininizde 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ı o dosya yolunda arar.

Bu dosyayı oluşturmanın en kolay yolu, googleads.properties öğesini GitHub deposundan kopyalayıp istemci kimliği, istemci gizli anahtarı ve yenileme jetonunuzu içerecek şekilde değiştirmektir.

Dinamik yapılandırma

Yapılandırmayı, kitaplığı örneklendirirken 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"
});

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

$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");

Ayrıca, API Client üzerinden bir OAuth2ApplicationsHandler nesnesi alabilir, çalışma zamanında istemci kimliği, istemci gizli anahtarı 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 başlatırken ortam değişkenlerinden bazı yapılandırma ayarlarını belirleyebilirsiniz (kapsamlı listeyi inceleyin).

İstemci modülü, ortam değişkenlerindeki değerleri 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 mevcut olan alanlar:

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

API İstemcisi'nde devam eden alanlar:

  • developer_token: API'ye erişmek için geliştirici jetonunuz.
  • login_customer_id: login-customer-id dokümanlarına bakın.
  • proxy: İnternet bağlantısı için kullanılan proxy sunucu URL'si.