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:
developer_token
: token programisty umożliwiający dostęp do interfejsu API.login_customer_id
: zapoznaj się z dokumentacją dotyczącą identyfikatora klienta loginu.proxy
: adres URL serwera proxy używany do łączenia się z internetem.