Клиентская библиотека Ads API предоставляет несколько параметров конфигурации, которые можно использовать для настройки поведения библиотеки.
Файл конфигурации
Вы можете указать файл googleads.properties
, который будет использоваться при создании экземпляра клиента.
Если при создании экземпляра не используются аргументы:
my $api_client = Google::Ads::GoogleAds::Client->new();
то библиотека будет искать файл в вашем HOME
каталоге.
В качестве альтернативы вы можете указать путь:
my $properties_file = "/path/to/googleads.properties";
my $api_client = Google::Ads::GoogleAds::Client->new({
properties_file => $properties_file
});
в этом случае клиент будет искать файл по указанному пути.
Самый простой способ создать этот файл — скопировать файл googleads.properties
из репозитория GitHub и изменить его, включив в него идентификатор клиента, секретный код клиента и токен обновления.
Динамическая конфигурация
Вы можете настроить конфигурацию динамически при создании экземпляра библиотеки или даже позже:
my $api_client = Google::Ads::GoogleAds::Client->new({
developer_token => "INSERT_DEVELOPER_TOKEN_HERE",
login_customer_id => "INSERT_LOGIN_CUSTOMER_ID_HERE"
});
Вы даже можете изменить конфигурацию после создания экземпляра:
$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");
Вы также можете получить объект OAuth2ApplicationsHandler из API Client
и изменить идентификатор клиента, секрет клиента и токен обновления во время выполнения:
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");
Переменные среды конфигурации
Вы можете задать некоторые параметры конфигурации из переменных среды при создании экземпляров клиентов (см. исчерпывающий список ).
Модуль Client предоставляет функцию configure_from_environment_variables
для загрузки значений из переменных среды:
# 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();
Поля конфигурации
Свойства конфигурации поддерживают следующие поля:
Поля сохраняются в OAuth2ApplicationsHandler :
-
client_id
: Ваш идентификатор клиента OAuth2. -
client_secret
: Ваш секретный ключ клиента OAuth2. -
refresh_token
: ваш токен обновления OAuth2.
Поля, сохраненные в API-клиенте :
-
developer_token
: Ваш токен разработчика для доступа к API. -
login_customer_id
: См . документацию по login-customer-id . -
proxy
: URL-адрес прокси-сервера, используемый для подключения к Интернету.