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

library akan mencari file tersebut di direktori HOME Anda.

Atau, Anda dapat menetapkan jalur:

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

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

dalam kasus ini, klien akan mencari file di jalur file tersebut.

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

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 mengubah konfigurasi setelah pembuatan instance:

$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");

Anda juga bisa mendapatkan objek OAuth2ApplicationsHandler dari API Client, dan mengubah client ID, rahasia klien, dan token refresh pada 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 ID pelanggan-login.
  • proxy: URL server proxy yang digunakan untuk konektivitas internet.