Konfiguracja

Biblioteka klienta interfejsu Google Ads API udostępnia kilka ustawień konfiguracyjnych, których możesz użyć do dostosowania jej działania.

Plik konfiguracji

Podczas tworzenia instancji klienta możesz określić plik googleads.properties.

Jeśli podczas tworzenia instancji nie użyjesz żadnych argumentów:

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

biblioteka będzie szukać pliku w Twoim katalogu HOME.

Możesz też określić ścieżkę:

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

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

w takim przypadku klient będzie szukać pliku w tej ścieżce.

Najłatwiej jest wygenerować ten plik, kopiując googleads.properties z repozytorium GitHub i modyfikując go, aby zawierał identyfikator klienta, tajny klucz klienta i token odświeżania.

Konfiguracja dynamiczna

Konfigurację możesz skonfigurować dynamicznie podczas tworzenia instancji biblioteki lub nawet później:

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

Możesz nawet zmodyfikować konfigurację po utworzeniu instancji:

$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");

Możesz też pobrać obiekt OAuth2ApplicationsHandler z API Client, i zmienić identyfikator klienta, tajny klucz klienta i token odświeżania w czasie działania:

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

Zmienne środowiskowe konfiguracji

Podczas tworzenia instancji klientów możesz ustawić niektóre ustawienia konfiguracyjne ze zmiennych środowiskowych (zobacz pełną listę).

Moduł Client udostępnia funkcję configure_from_environment_variables do wczytywania wartości ze zmiennych środowiskowych:

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

Pola konfiguracji

Właściwości konfiguracji obsługują te pola:

Pola utrwalone w OAuth2ApplicationsHandler:

  • client_id: identyfikator klienta OAuth2.
  • client_secret: tajny klucz klienta OAuth2.
  • refresh_token: token odświeżania OAuth2.

Pola utrwalone w kliencie interfejsu API: