Konfiguracja

Biblioteka klienta interfejsu Ads API udostępnia kilka ustawień konfiguracji, których możesz używać do dostosowywania działania biblioteki.

Plik konfiguracji

Możesz określić plik googleads.properties, który będzie używany podczas tworzenia instancji klienta.

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

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

to biblioteka poszuka pliku w katalogu HOME.

Możesz też podać ś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 odszuka plik pod tą ścieżką.

Najprostszym sposobem wygenerowania tego pliku jest skopiowanie pliku googleads.properties z repozytorium GitHub i zmodyfikowanie go, tak 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({
  developer_token   => "INSERT_DEVELOPER_TOKEN_HERE",
  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 oraz 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

Niektóre ustawienia konfiguracji możesz zmieniać na podstawie zmiennych środowiskowych podczas inicjowania klientów (zobacz pełną listę).

Moduł klienta zawiera 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 zostały zachowane w metodzie OAuth2ApplicationsHandler:

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

Pola zostały zachowane w kliencie interfejsu API:

  • developer_token: token programisty pozwalający na dostęp do interfejsu API.
  • login_customer_id: zapoznaj się z dokumentacją login-customer-id.
  • proxy: adres URL serwera proxy używanego do połączenia z internetem.