Konfiguracja

Biblioteka klienta interfejsu API Google Ads zawiera kilka ustawień, których możesz użyć, aby dostosować jej działanie.

Plik konfiguracji

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

Jeśli przy tworzeniu instancji nie używasz żadnych argumentów:

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

to biblioteka wyszuka w katalogu HOME ten plik.

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
});

W takim przypadku klient będzie szukał pliku w tej ścieżce.

Najprostszym sposobem na wygenerowanie tego pliku jest skopiowanie googleads.properties z repozytorium GitHub i zmodyfikowanie go w celu dodania identyfikatora klienta, tajnego klucza klienta i tokena odświeżania.

Konfiguracja dynamiczna

Konfigurację możesz skonfigurować dynamicznie podczas tworzenia biblioteki, a nawet po tym czasie:

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ż 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 środowiska konfiguracji

Niektóre ustawienia możesz skonfigurować ze zmiennych środowiskowych podczas stymulowania klientów (zobacz pełną listę).

Moduł klienta udostępnia 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 liście OAuth2ApplicationsHandler:

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

Pola utrwalone na koncie klienta API: