Konfiguracja

Biblioteka klienta interfejsu Ads API udostępnia kilka ustawień konfiguracji, które pozwalają dostosowywać działanie biblioteki.

Plik konfiguracji

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

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

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

biblioteka będzie szukać 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 będzie szukać pliku pod tą ścieżką.

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 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 zmienić konfigurację po utworzeniu instancji:

$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 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 inicjowania klientów możesz skonfigurować niektóre ustawienia konfiguracji ze zmiennych środowiskowych (zobacz pełną listę).

Moduł klienta zawiera funkcję configure_from_environment_variables służącą 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 zachowane w metodzie OAuth2ApplicationsHandler:

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

Pola zachowane w kliencie interfejsu API: