Конфигурация

Клиентская библиотека 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 : см. документацию по логину-customer_id .
  • proxy : URL-адрес прокси-сервера, используемый для подключения к Интернету.