Настройка клиентской библиотеки Java

Библиотека ищет файл конфигурации в System.getProperty("user.home") + "/searchads360.properties".

Файл конфигурации представляет собой файл Properties Java с парами "ключ-значение". Поддерживаемые ключи зависят от выбранного способа аутентификации.

Поддерживаемые ключи для компьютерных и веб-приложений

Если вы используете компьютерное или веб-приложение, поддерживаются следующие ключи:

# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
api.searchads360.clientId=INSERT_CLIENT_ID_HERE

# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
api.searchads360.clientSecret=INSERT_CLIENT_SECRET_HERE

# Renewable OAuth credential associated with 1 or more Search Ads accounts.
api.searchads360.refreshToken=INSERT_REFRESH_TOKEN_HERE

# Required for manager accounts only: Specify the login customer ID used to
# authenticate API calls. This will be the customer ID of the authenticated
# manager account. You can also specify this later in code if your application
# uses multiple manager account + OAuth pairs.
#
# api.searchads360.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

Как комбинировать разные подходы к настройке

Класс SearchAds360Client и его конструктор поддерживают сочетание разных стратегий настройки. Например, вы можете использовать файл свойств, чтобы настроить учетные данные экземпляра и другие атрибуты, как показано в следующем фрагменте кода.

SearchAds360Client searchAds360Client = SearchAds360Client.newBuilder()
    .fromPropertiesFile()
    .build();

Вы можете внести дополнительные изменения во время выполнения, используя другие методы конфигурации построителя, прежде чем вызывать build().

Если вы выполняете аутентификацию в качестве управляющего аккаунта, вам также необходимо указать:

api.searchads360.loginCustomerId --> Manager account ID (with hyphens removed).