Konfiguration der Java-Clientbibliothek

Die Bibliothek sucht in System.getProperty("user.home") + "/searchads360.properties" nach einer Konfigurationsdatei.

Die Konfigurationsdatei hat das Format einer Java-Properties-Datei mit Schlüssel/Wert-Paaren. Die unterstützten Schlüssel variieren je nach ausgewähltem Authentifizierungsablauf.

Unterstützte Schlüssel für Desktop- und Webanwendungs-Flows

Wenn Sie den Desktop- oder Webanwendungsablauf verwenden, werden die folgenden Schlüssel unterstützt:

# 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


Konfigurationsansätze kombinieren

SearchAds360Client und der zugehörige Builder unterstützen die Kombination verschiedener Konfigurationsstrategien. Sie können beispielsweise eine Eigenschaftendatei verwenden, um die Anmeldedaten der Instanz und andere Attribute mit dem folgenden Snippet zu konfigurieren.

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

Sie können zur Laufzeit weitere Änderungen mit den anderen Konfigurationsmethoden des Builders vornehmen, bevor Sie build() aufrufen.

Wenn Sie sich als Verwaltungskonto authentifizieren, müssen Sie zusätzlich Folgendes angeben:

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