Yapılandırma

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

Yapılandırma dosyası

İstemciyi oluştururken kullanılacak bir googleads.properties dosyası belirtebilirsiniz.

Örnek oluştururken herhangi bir bağımsız değişken kullanmıyorsanız:

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

Bu durumda kitaplık, dosya için HOME dizininize bakar.

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ı söz konusu dosya yolunda arar.

Bu dosyayı oluşturmanın en kolay yolu, GitHub deposundan googleads.properties öğesini 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ığı oluştururken dinamik olarak veya daha sonra ayarlayabilirsiniz:

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

Yapılandırmayı örnek oluşturulduktan sonra bile değiştirebilirsiniz:

$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");

Ayrıca API Client'dan 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 oluştururken yapılandırma ayarlarının bazılarını ortam değişkenlerinden ayarlayabilirsiniz (kapsamlı 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 içinde kalıcı hale getirilen alanlar:

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

API İstemcisi'nde kalıcı hale getirilen 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.