Konfiguracja

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

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

Plik konfiguracji

Możesz określić plik googleads.properties, który ma być używany do tworzenia instancji klienta.

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

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

to biblioteka wyszuka ten plik w 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
});

i w takim przypadku klient szuka pliku w danej ścieżce pliku.

Najprostszym sposobem wygenerowania tego pliku jest skopiowanie 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, a nawet po jej zakończeniu:

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 modyfikować 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 można skonfigurować ze zmiennych środowiskowych podczas stymulowania klientów (zobacz pełną listę).

Moduł klienta zawiera funkcję configure_from_environment_variables, która wczytuje 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 na stronie OAuth2ApplicationsHandler:

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

Pola zachowane w kliencie interfejsu API: