Konfiguracja

Biblioteka klienta Ads API udostępnia kilka ustawień konfiguracji, za pomocą których możesz dostosować działanie biblioteki.

Plik konfiguracji

Możesz określić plik googleads.properties, którego chcesz użyć podczas tworzenia instancji klienta.

Jeśli podczas tworzenia wystąpienia nie używasz żadnych argumentów:

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

wtedy biblioteka odnajdzie plik 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 tym przypadku klient będzie szukać pliku pod podaną ścieżką.

Najprostszym sposobem wygenerowania tego pliku jest skopiowanie pliku googleads.properties z repozytorium GitHub i zmodyfikowanie go tak, aby zawierał identyfikator klienta, obiekt tajny 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"
});

Konfigurację możesz zmodyfikować nawet po jej uruchomieniu:

$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");

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

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 ustawić za pomocą zmiennych środowiskowych podczas tworzenia instancji klientów (patrz pełna lista).

Moduł Client udostępnia funkcję configure_from_environment_variablesdo 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 zapisane w OAuth2ApplicationsHandler

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

Pola zapisane w Klient API:

  • developer_token: Twój token dewelopera umożliwiający dostęp do interfejsu API.
  • login_customer_id: zapoznaj się z dokumentacją login-customer-id.
  • proxy: adres URL serwera proxy używanego do łączenia się z internetem.