Yapılandırma

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.