Konfigurasi

Library Klien Ads API menyediakan beberapa setelan konfigurasi yang dapat Anda gunakan untuk menyesuaikan perilaku library.

File konfigurasi

Anda dapat menentukan file googleads.properties yang akan digunakan saat membuat instance klien.

Jika Anda tidak menggunakan argumen saat membuat instance:

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

maka library akan mencari file tersebut di direktori HOME Anda.

Atau, Anda dapat menentukan jalur:

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

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

dalam hal ini klien akan mencari file di jalur file itu.

Cara termudah untuk membuat file ini adalah dengan menyalin googleads.properties dari repositori GitHub dan mengubahnya agar menyertakan client ID, rahasia klien, dan token refresh Anda.

Konfigurasi dinamis

Anda dapat menyiapkan konfigurasi secara dinamis saat membuat instance library, atau bahkan setelahnya:

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

Anda bahkan dapat memodifikasi konfigurasi setelah pembuatan instance:

$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");

Anda juga bisa mendapatkan objek OAuth2ApplicationsHandler dari API Client, serta mengubah client ID, rahasia klien, dan token refresh saat runtime:

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");

Variabel lingkungan konfigurasi

Anda dapat menetapkan beberapa setelan konfigurasi dari variabel lingkungan saat membuat instance klien (lihat daftar lengkap).

Modul Klien menyediakan fungsi configure_from_environment_variables untuk memuat nilai dari variabel lingkungan:

# 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();

Kolom konfigurasi

Properti konfigurasi mendukung kolom berikut:

Kolom yang dipertahankan di OAuth2ApplicationsHandler:

  • client_id: Client ID OAuth2 Anda.
  • client_secret: Rahasia klien OAuth2 Anda.
  • refresh_token: Token refresh OAuth2 Anda.

Kolom yang dipertahankan di Klien API:

  • developer_token: Token developer Anda untuk mengakses API.
  • login_customer_id: Lihat dokumentasi login-customer-id.
  • proxy: URL server proxy yang digunakan untuk konektivitas internet.