Konfigurasi

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

File konfigurasi

Anda dapat menentukan googleads.properties yang 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 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 tersebut.

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

Konfigurasi dinamis

Anda bisa 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 OAuth2ApplicationsHandler dari API Client, dan mengubah client ID, rahasia klien, dan me-refresh token 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 panduan daftar).

Modul Klien menyediakan 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 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.