Configurazione della libreria client Java

La libreria cerca un file di configurazione in System.getProperty("user.home") + "/searchads360.properties".

Il formato del file di configurazione è quello di un file Proprietà Java di coppie chiave-valore. Le chiavi supportate variano a seconda del flusso di autenticazione scelto.

Chiavi supportate per i flussi di applicazioni web e desktop

Se utilizzi il flusso dell'applicazione desktop o web, le chiavi supportate sono le seguenti:

# 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


Combinare approcci di configurazione

SearchAds360Client e il relativo builder supportano la combinazione di diverse strategie di configurazione. Ad esempio, puoi utilizzare un file delle proprietà per configurare le credenziali dell'istanza e per altri attributi utilizzando lo snippet riportato di seguito.

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

Puoi apportare ulteriori modifiche in fase di runtime utilizzando gli altri metodi di configurazione del generatore prima di chiamare build().

Se esegui l'autenticazione come account amministratore, devi specificare inoltre:

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