Configuração da biblioteca de cliente do Java

A biblioteca procura um arquivo de configuração em System.getProperty("user.home") + "/searchads360.properties".

O formato do arquivo de configuração é o de um arquivo Properties (em inglês) Java de pares de chave-valor. As chaves compatíveis variam de acordo com o fluxo de autenticação escolhido.

Chaves compatíveis para fluxos de aplicativos da Web e de computador

Se você estiver usando o fluxo de aplicativos para computador ou Web, as chaves compatíveis serão as seguintes:

# 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


Combinar abordagens de configuração

A SearchAds360Client e o builder dela são compatíveis com a combinação de diferentes estratégias de configuração. Por exemplo, é possível usar um arquivo de propriedades para configurar as credenciais da instância e para outros atributos usando o snippet a seguir.

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

É possível fazer outras alterações no momento da execução usando os outros métodos de configuração do builder antes de chamar build().

Para fazer a autenticação como uma conta de administrador, também é necessário especificar:

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